Bug, Richieste e Segnalazioni ¶

QGIS è un progetto largamente mantenuto da volontari, ed è il lavoro di un team di sviluppatori, documentatori, traduttori e sostenitori dediti. Nonostante gli sforzi del team di rilasciare QGIS senza bug, ne può rimanere qualcuno. Se scopri un bug o vuoi nuove funzionalità, segnalalo!

Dove segnalare? ¶

Ogni parte del progetto QGIS ha un luogo dedicato dove i problemi (richieste di funzionalità o bug) possono essere segnalati, gestiti e discussi. A seconda dell’area in cui hai riscontrato il problema, la tabella seguente indica il repository corretto per segnalarlo:

For help and questions, please contact the Mailing lists.

Segnalare problemi su applicazioni QGIS ¶

QGIS applications (QGIS Desktop and QGIS Server) issues are available in Github. In order to submit or comment a report, you need to register and login.

Prima di riportare un problema ¶

Before filing an issue, verify that you are running the currently supported versions 3.44.11 or 4.0.3 or the development version 4.1 (see also Release schedule) 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.

When you’re logged in, a New Issue button is available. Select it and follow the instructions there.

Before sending the report, please check the formatting of your report by clicking on “Preview”. Please avoid editing existing reports, if not for typos. Better add further comments in any other case.

Creazione di una backtrace ¶

Se hai un crash potrebbe essere utile includere una backtrace poiché il bug potrebbe non essere riproducibile su un’altra macchina.

On Linux QGIS automatically tries to use gdb to connect to the crashing process to produce a backtrace. But some distributions disable the possiblity to connect debuggers to a running processes. In that case gdb only produces a rather useless message like:

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)

In that case you should reenable that option by setting kernel.yama.ptrace_scope to 0 in /etc/sysctl.d/10-ptrace.conf (or /etc/sysctl.conf or some other file in /etc/sysctl.d/) and run sysctl -p as root. When you reproduce the crash after that, a backtrace will be printed instead.

If you cannot reproduce the crash, there should still be a core dump in the current directory, that can be analysed after the process has already terminated. It’s called core, though the filename may include a dot followed by the process id on some systems.

On some distributions the creation of core dumps is also disabled. In the event that you just get Aborted instead of Aborted (core dumped) when the crash occurs. Then you need to run ulimit -c unlimited before starting QGIS. You can also include that in your .profile, so that it’s always enabled when you login.

To produce a backtrace from the core file, start gdb /path/to/the/qgis/binary core. The binary is usually /usr/bin/qgis or /usr/bin/qgis.bin on Debian with the GRASS plugin installed. In gdb you run bt which will produce the backtrace.

Log output in Windows ¶

The nightly build in OSGeo4W (package qgis-dev) is built with debugging output, that you can view with DebugView. If the problem is not easy to reproduce, the output might shed some light about where QGIS crashes.

Segnalare problemi sul sito web QGIS o sulla documentazione ¶

QGIS project provides an active web site and a rich documentation. Despite our efforts, if you find an out of date information, a wrong or unclear statement or miss valuable information, please feel free to report it.

Le sorgenti principali di questi documenti sono ospitate e gestite su repository GitHub per cui, per riportare bug o inviare patch, hai bisogno di un account GitHub e di eseguire l’accesso.

To get started, first Create a GitHub account.

In seguito, scegli il repository appropriato:

• https://github.com/qgis/QGIS-Documentation/issues per la documentazione QGIS
• https://github.com/qgis/QGIS-Website/issues per il sito web

Check if the issue you’d like to report is not already entered.

Clicca su Nuova Segnalazione, digita un titolo e una descrizione chiara per il tuo problema.

When you’re finished, click Submit new issue.

Note

A Fix me link is provided at the bottom of any page of the web site to help you directly improve this page and submit pull request.

Questa opzione è anche disponibile nel piè di pagina della documentazione.

Segnalazione di problemi con i plugin ¶

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 is provided.

Invio di una Patch ai progetti QGIS ¶

In addition to issue report, you can help to fix issues. Fixing issues is done in GitHub through pull requests. You need to fork the repository you want to contribute to and submit pull requests at:

• https://github.com/qgis/QGIS per applicazioni QGIS Desktop o QGIS Server
• https://github.com/qgis/QGIS-Website per il sito web su https://qgis.org
• https://github.com/qgis/QGIS-Documentation per la documentazione disponibile su 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.