Erori, funcționalități și probleme

QGIS este un proiect dirijat în mare parte de către voluntari, fiind opera unei echipe dedicate de dezvoltatori, documentatori, traducători și susținători. În ciuda eforturilor echipei de a livra QGIS fără erori, este posibil să rămână unele probleme. Dacă ați identificat o defecțiune sau dacă doriți adăugarea de noi funcțiuni, vă rugăm să raportați!

Where to report?

Each part of the QGIS Project has a dedicated place where issues (feature requests or bugs) can be reported, managed and discussed. Depending on the area you encountered the issue, the table below indicates the right repository to report it:

Place you found the bug or request a feature for Place to report the issue
Applications (QGIS Desktop, QGIS Server) https://github.com/qgis/QGIS/issues
QGIS Website (https://qgis.org) https://github.com/qgis/QGIS-Website/issues
QGIS Documentation (https://docs.qgis.org) https://github.com/qgis/QGIS-Documentation/issues
External plugins The author repository set in the plugin description

For help and questions, please contact the Liste de discuții.

Raportarea problemelor referitoare la aplicațiile 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.

Înainte de a raporta o problemă

Înainte de a raporta o eroare, analizați problemele deschise în prezent pentru a vă asigura că nu se creează un duplicat. Dacă aveți informații suplimentare despre o problemă, le puteți adăuga la tichetul existent. Plugin-urile produse de terțe părți ar putea provoca, de asemenea, probleme. Dacă aveți plugin-uri instalate, ar trebui, de asemenea, să verificați dacă problema persistă și în lipsa lor. Vă rugăm să nu raportați mai multe erori într-un singur raport.

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

Înainte de a trimite problema, vă rugăm să verificați formatul de raport, făcând clic pe „Previzualizare”. Vă rugăm să evitați editarea rapoartelor existente, în afara corectării greșelilor de ortografiere. Cel mai bine ar fi să adăugați comentarii ulterioare.

Crearea unui fișier de excepții

Dacă întâmpinați o defecțiune ar fi util să includeți și un backtrace, deoarece este posibil ca eroarea să nu poată fi reprodusă pe o altă mașină.

Pe Linux, QGIS încearcă automat să utilizeze gdb pentru a se conecta la procesul de tratare a erorilor, în scopul producerii unui fișier de excepții. Însă unele distribuții dezactivează posibilitatea de conectare a depanatoarelor la procesele care rulează. În acest caz, gdb va produce doar un mesaj destul de inutil ca:

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)

În acest caz, ar trebui să reactivați această opțiune prin setarea kernel.yama.ptrace_scope la 0 în /etc/sysctl.d/10-ptrace.conf (sau /etc/sysctl.conf sau oricare alt fișier din /etc/sysctl.d/) și prin rularea sysctl -p ca root. Când veți reproduce ulterior eroarea, se va imprima un jurnal de excepții.

Dacă nu puteți reproduce eroarea, ar trebui să existe totuși un fișier de bază în directorul curent, care să poată fi analizat după ce procesul a fost terminat. Acesta se numește core (pe unele sisteme, la numele fișierului se adaugă un punct și id-ul procesului).

Pe unele distribuții crearea de fișiere de excepții este, de asemenea, dezactivată. În acest caz veți apăsa pe Aborted în loc de Aborted (core dumped), atunci când se produce o defecțiune. Apoi, trebuie să rulați ulimit -c unlimited înainte de a lansa QGIS. Puteți include, de asemenea, fișierul .profile, acesta fiind întotdeauna activat, atunci când vă conectați.

Pentru a produce un fișier de excepții din aplicația principală, startați gdb /path/to/the/qgis/binary core. Fișierul binar este, de obicei, /usr/bin/qgis sau /usr/bin/qgis.bin pe Debian, dacă pluginul GRASS este instalat. În gdb veți rula bt care va produce fișierul de excepții.

Jurnalizați ieșirele pe Windows

Compilația nocturnă din OSGeo4W (pachetul qgis-dev) este construită cu ieșire de depanare, care se poate vizualiza cu DebugView. În cazul în care problema nu este ușor de reprodus, ieșirea ar putea facă lumină cu privire la motivele pentru care QGIS se închide pe neașteptate.

Raportarea problemelor referitoare la site-ul web QGIS sau la documentație

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 a valuable information, please feel free to report it.

Principalele surse ale acestor documente sunt găzduite și gestionate în depozitele GitHub, astfel încât, în scopul raportării de erori sau al transmiterii de corecții, aveți nevoie de autentificarea într-un cont GitHub.

Pentru a începe, mai întâi Creați un cont GitHub.

Apoi, alegeți depozitul adecvat:

Verificați dacă problema pe care doriți să o raportați nu este introdusă deja.

Clic pe Problemă Nouă, introduceți un titlu și o descriere clară pentru problemă.

Când ați terminat, faceți clic pe Transmitere problemă nouă.

Notă

Un link de Remediere este prezent în partea de jos a oricărei pagini a site-ului, pentru a vă ajuta la îmbunătățirea imediată a unei pagini și pentru a transmite solicitări de modificare.

Această opțiune este disponibilă și în subsolul documentației.

Reporting plugin issues

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.

Submitting a Patch to QGIS projects

În plus față de raportarea problemelor, puteți ajuta la rezolvarea lor. Remedierea problemelor se face în GitHub prin efectuarea unei solicitări. Trebuie să efectuați o copie a depozitului la care doriți să contribuiți, apoi să efectuați o solicitare:

You can find a few guidelines that will help you to easily get your patches and pull requests into QGIS projects at submit_patch. And more widely, You may need to read git_access.