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ă ne transmiteți un raport!
Fiecare parte a proiectului QGIS are un loc dedicat, în care pot fi raportate, gestionate și discutate problemele (cereri de noi funcțiuni sau raportare de erori). În funcție de zona în care ați întâlnit problema, tabelul de mai jos indică depozitul potrivit pentru a o raporta:
Zona în care ați identificat eroarea sau pentru care solicitați o nouă funcționalitate |
Adresa de raportare a problemei |
|---|---|
Aplicații (QGIS Desktop, QGIS Server) |
|
Site web QGIS (https://qgis.org) |
|
Documentație QGIS (https://docs.qgis.org) |
|
C++ API (https://qgis.org/api) |
|
PyQGIS API (https://qgis.org/pyqgis) |
https://github.com/qgis/QGIS/issues (pentru conținut) și https://github.com/qgis/pyqgis/issues (pentru formatare) |
Plugin-uri externe |
Depozitul autorului este specificat în descrierea pluginului |
Puteți transmite întrebările dvs. pe Liste de discuții.
Problemele aplicațiilor QGIS (QGIS Desktop și QGIS Server) sunt disponibile în `Github<https://github.com/qgis/QGIS/issues>`_. Pentru a trimite sau pentru a comenta un raport, trebuie să vă înregistrați și să vă autentificați.
Înainte de a raporta o eroare, verificați dacă rulați versiunile acceptate în prezent 3.34.5, 3.36.1 sau versiunea de dezvoltare 3.37 (consultați și Planificarea versiunilor) și examinați problemele deschise în prezent pentru a vă asigura că nu creați 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.
După ce v-ați conectat, este disponibil butonul Problemă Nouă. Selectați-l și urmați instrucțiunile de acolo.
Î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.
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.
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.
Proiectul QGIS oferă un site web activ și o documentație bogată. În ciuda eforturilor noastre, dacă găsiți o informație învechită, o declarație greșită sau neclară, sau dacă o informație valoroasă lipsește, nu ezitați să raportați aceste lucruri.
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:
https://github.com/qgis/QGIS-Documentation/issues pentru documentația QGIS
https://github.com/qgis/QGIS-Website/issues pentru site-ul web
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.
Majoritatea pluginurilor din QGIS sunt publicate în depozitul oficial de pluginuri QGIS. Erorile sau solicitările de noi funcționalități pentru pluginuri trebuie să fie deschise în sistemul urmărire a erorilor al pluginului în cauză:
Pentru orice plugin disponibil în depozitul QGIS, veți găsi în metadatele sale un link către sistemul de semnalare a erorilor. În caz contrar, consultați documentația pluginului, pentru a găsi adresa unui sistem relevant de urmărire a erorilor, sau pentru a contacta un dezvoltator.
Dacă nu sunt disponibile informații, vă rugăm să o raportați în Lista de corespondență a dezvoltatorilor.
Pentru alte plugin-uri, nu avem mijloace pentru a ne asigura că aceste informații sunt furnizate.
Î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:
https://github.com/qgis/QGIS pentru QGIS Desktop sau aplicațiile QGIS Server
https://github.com/qgis/QGIS-Website pentru site-ul web de la https://qgis.org
https://github.com/qgis/QGIS-Documentation for the documentation available at https://docs.qgis.org
Puteți găsi unele indicații care vă vor ajuta să obțineți cu ușurință corecții și să transmiteți solicitări de modificare ale proiectelor QGIS, accesând Submitting Pull Requests. De asemenea, poate că ar trebui să citiți capitolul Procesul de Dezvoltare.