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 espace dédié où les demandes (fonctionnalités ou bogues) peuvent être rapportées, gérées et discutées. Selon le secteur concerné par votre demande, cette table vous indique le site sur lequel faire le signalement :
Le bogue ou la requête concerne |
Signaler à |
|---|---|
Applications (QGIS Desktop, QGIS Server) |
|
Site web de QGIS (https://qgis.org) |
|
Documentation de QGIS (https://docs.qgis.org) |
|
API C++ (https://qgis.org/api) |
|
API PyQGIS (https://qgis.org/pyqgis) |
https://github.com/qgis/QGIS/issues (pour le contenu) et https://github.com/qgis/pyqgis/issues (pour le formatage) |
Extensions complémentaires |
Le dépôt de l’auteur défini dans la description de l’extension |
Pour toute question, veuillez contacter une des listes présentes dans Listes de diffusion.
Les problèmes liés aux applications QGIS (QGIS Desktop et QGIS Server) sont regroupés dans Github. Pour soumettre ou commenter un problème, vous devez être enregistré et connecté.
Before filing an issue, verify that you are running the currently supported versions 3.34.5 or 3.36.1 or the development version 3.37 (see also Calendrier de sortie) and review the currently open issues to make sure that you aren’t creating a duplicate. If you have additional information on an issue, you can add it to the existing ticket. Third party plugins might also cause problems. If you have installed any, you should also verify that the problem is still reproducible without them. Please don’t report multiple unrelated bugs in a single bug report.
Une fois connecté, un bouton New Issue est disponible. Cliquez dessus et suivez les instructions.
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.
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.
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.
Le projet QGIS fournit un site web actif et une riche documentation. Malgré nos efforts, si vous trouvez une information obsolète, une affirmation 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é :
https://github.com/qgis/QGIS-Documentation/issues pour les manuels de QGIS
https://github.com/qgis/QGIS-Website/issues pour le site web
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.
La plupart des extensions de QGIS sont publiées dans le dépôt officiel des extensions QGIS. Les bogues ou demandes de fonctionnalité qui leur sont liées doivent impérativement être ouverts dans leur propre dépôt de suivi de bogues.
Pour une extension disponible dans le dépôt des extensions de QGIS, vous trouverez dans ses métadonnées un lien vers son système de suivi de bogues. Dans le cas contraire, consultez la documentation de l’extension pour trouver l’emplacement du système de suivi de bogues ou un contact vers le développeur.
Si aucune information n’est disponible, veuillez le rapporter sur la Liste de diffusion des développeurs.
Pour d’autres extensions, nous n’avons aucun moyen de savoir si ces informations sont fournies.
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 :
https://github.com/qgis/QGIS pour les applications QGIS Desktop et QGIS Server
https://github.com/qgis/QGIS-Website pour le site web à https://qgis.org
https://github.com/qgis/QGIS-Documentation pour la documentation disponible à https://docs.qgis.org
You can find a few guidelines that will help you to easily get your patches and pull requests into QGIS projects at Submitting Pull Requests. And more widely, You may need to read the Development Process chapter.