Bogues, Fonctionnalités et Demandes

QGIS est un projet majoritairement géré par des volontaires et est le fruit du travail d’une équipe engagée de développeurs, de rédacteurs de documentation, de traducteurs et de supporteurs. Malgré les efforts de l’équipe pour publier QGIS sans bogue, ces derniers peuvent néanmoins être présents. Si vous en trouvez un ou si vous voulez avoir de nouvelles fonctionnalités, merci de faire un rapport !

Chaque partie du projet QGIS a un endroit dédié où les demandes (fonctionnalités ou bugs) peuvent être rapportées, gérées and discutées. Vous trouverez des demandes en lien avec :

Pour toute question, veuillez contacter une des listes présentes dans Listes de diffusion.

Signalements liés aux applications

QGIS applications (QGIS Desktop, QGIS Browser and QGIS Server) issues are available in Redmine. In order to submit or comment a report, you need an OSGeo account and login. To get started, first Create an OSGeo account. It may require some time to have your account approved.

Note

Sur la page OSGeo des identifiants utilisateurs , vous pouvez trouver plus d’informations sur l’identifiant OSGeo que nous utilisons. Vous pourrez par exemple y modifier votre mot de passe, votre adresse électronique ou encore réinitialiser votre mot de passe .

Avant d’effectuer un signalement

Avant de reporter un bogue, vérifiez ceux déjà signalés pour vous assurer que vous n’êtes pas en train de créer un doublon. Si vous avez des informations supplémentaires sur un problème, vous pouvez les ajouter à un ticket existant. Les extensions tierces peuvent également poser des problèmes. Si vous en avez installées, vérifiez que le problème persiste en leur absence. Ne signalez pas de multiples bogues non reliés entre eux dans un même ticket.

Les étapes à suivre

Une fois que votre compte est validé et que vous êtes connecté, un onglet Nouvelle demande est disponible dans la barre de menus. Cliquez dessus.

Informations importantes nécessaires à l’ouverture d’un billet:

  • Tracker - choisissez le type de ticket à partir de la liste déroulante : Bogue, Fonctionnalité (demande de nouvelle fonctionnalité)
  • Sujet - une brève description de la demande
  • Description - Provide a full description of the problem including steps to repeat it; if you think the bug could be related to a certain platform version or dependencies package version (GDAL, OGR, GEOS etc) include that as well. If your QGIS crashes it might be useful to include a backtrace (see below). A very important thing when reporting a bug is to boil down a minimum example that is needed to reproduce the bug. The chances of a bug being addressed in a timely manner is directly related to the speed with which the developer can reproduce the bug. If you make that hard for the developer, chances are the bug will be given up on or ignored for quite a while.
  • Priorité - fournit une estimation de la sévérité du problème :
    • Faible : un problème qui n’affecte pas le fonctionnement de QGIS,
    • Normal : la valeur par défaut, applicable à la plupart des bogues et demandes de fonctionnalité,
    • High: a bug which has a major effect on the usability of a package or a bug that makes QGIS totally unusable. In the form you will find also yes/no fields to allow you detail of the issue is causing a crash or data corruption or if it is a regression (a regression is an issue about a functionality that used to work as expected and then stopped to work in more recent QGIS release)
  • Catégorie - Choisir le partie du logiciel qui est la plus proche du problème
  • Affected QGIS Version - Version of QGIS this issue affects
  • Operating System - The Operating System(s) you are using (and also their version), i.e: Windows 7, macOS 10.12.4, Ubuntu 16.04

Avant d’envoyer votre rapport, merci de vérifier son format en cliquant sur “Prévisualiser”. Merci d’éviter de modifier les rapports existants, à part pour les coquilles. Dans tous les autres cas, il est préférable de rajouter un commentaire.

Créer une backtrace

Si vous subissez un crash, il serait utile d’inclure un rapport de traces car le bogue n’est peut-être pas reproductible sur une autre machine.

Sous GNU/Linux, QGIS essaye d’utiliser automatiquement gdb pour se connecter au processus en échec et extraire les traces d’appel. Néanmoins, certaines distributions désactivent la possibilité de connecter des débogueurs sur des processus qui fonctionnent. Dans ce cas, gdb produira seulement un message assez peu utile tel que:

QGIS died on signal 11Could not attach to process.
If your uid matches the uid of the target process,
check the setting of /proc/sys/kernel/yama/ptrace_scope, or try
again as the root user.
For more details, see /etc/sysctl.d/10-ptrace.conf
ptrace: Operation not permitted.
No thread selected
No stack.
gdb returned 0
Aborted (core dumped)

Dans ce cas vous devriez ré-activer cette option en paramétrant kernel.yama.ptrac_scope à 0 dans /etc/sysctl.d/10-ptrace.conf (ou dans /etc/sysctl.conf ou tout autre fichier situé dans /etc/sysctl.d/) et lancer sysctl -p en tant qu’utilisateur root. Ainsi, lorsque vous reproduirez le crash par la suite, une trace d’appels sera affichée à la place.

Si vous ne pouvez pas reproduire le problème, il devrait quand même y avoir un fichier de vidage système (core dump) dans le répertoire courant. Il peut être analysé après la fin du processus. Il est nommé core (pour certains systèmes d’exploitation, un point et l’identifiant du processus est ajouté au nom de fichier).

Pour certaines distributions, la création de fichiers de vidage système est désactivée. Dans ce cas, vous aurez juste un message Avorté à la place de Avorté (core dumped) lorsque le problème survient. Vous devrez lancer ulimit -c unlimited avant de démarrer QGIS. Vous pouvez également inclure cette commande dans votre fichier .profile, de manière à la lancer à chaque fois que vous vous connectez.

Pour produire une trace d’appel (backtrace) à partir du fichier de vidage système (core), lancez gdb /path/to/the/qgis/binary core. Le binaire est généralement /usr/bin/qgis or /usr/bin/qgis.bin sous Debian avec l’extension GRASS installée. Dans gdb, lancez bt qui produira la trace d’appel.

Sauvegarder la sortie sur Windows

La pré-version compilée dans la version OSGeo4W (paquet qgis-dev) est compilée avec l’option de sortie de déboguage que vous pouvez visualiser avec DebugView. Si le problème n’est pas facile à reproduire, cette sortie devrait donner plus d’information sur l’endroit où QGIS crashe.

Bogues dans les extensions

Most of the plugins in QGIS are published in the official QGIS Plugins repository. Bugs or feature requests relative to them must be opened in their respective bug tracking system. For any plugin available in QGIS repository, you’ll find in its metadata a link to its bug tracker. Otherwise, consult the plugin documentation to find the address of the relevant bug tracking system or a developer to contact.

If no information is available, please report it to the Developer mailing-list.

For other plugins, we have no means to ensure such information are provided.

Signalements liés au site web de QGIS ou à la documentation

Le projet QGIS fournit un site web actif et une riche documentation. Malgré nos efforts, si vous trouvez une information périmée, une assertion fausse ou peu claire ou qu’il manque des informations d’intérêt, n’hésitez pas à le faire remonter.

La principale source de cette documentation est hébergée et gérée dans des dépôts sur GitHub. Pour remonter des bogues ou soumettre des patches, vous devez avoir un compte GitHub et vous connecter avec.

Pour commencer, Créez un compte GitHub.

Ensuite, choisissez le dépôt approprié :

Vérifiez si le problème que vous souhaitez remonter n’existe pas déjà.

Cliquez sur New Issue, ajouter un titre et une description claire de votre problème.

Lorsque vous avez terminé, cliquez sur Submit new issue.

Note

Un lien corrigez-moi est disponible au bas de chaque page du site web pour vous aider à améliorer la page de documentation et à soumettre une pull-request.

Cette option est également disponible dans le pied de page de la documentation.

Soumettre un patch

En plus de faire remonter les problèmes, vous pouvez nous aider à les régler. La résolution des problèmes est faite dans GitHub à travers les pull-requests. Vous devez créer un fork du dépôt si vous voulez contribuer au code et soumettre des pull-requests, ici :

Vous pouvez trouver quelques guides qui vous aideront à injecter vos patches et vos pull-requests dans les projets QGIS sur la page Soumettre des patchs et des pull-requests. Plus généralement, vous aurez sans doute besoin de lire Accès à GIT.