Riktai, savybės ir problemos

QGIS didžiąja dalimi yra savanorių vystomas projektas, tai dedikuotos programuotojų, kūrėjų, dokumentuotojų, vertėjų ir rėmėjų komandos darbo rezultatas. Nors komanda ir stengiasi QGIS išleisti be riktų, kai kurie jų gali likti. Jei randate riktą arba norite paprašyti pridėti naują savybę, prašome apie tai pranešti!

Kur pranešti?

Kiekviena QGIS projekto dalis turi savo vietą, kur registruojamos, valdomos ir aptariamos problemos (savybių prašymai ar riktai). Priklausomai nuo to, kur aptikote problemą, žemiau esančioje lentelėje rasite teisingą repozitoriją, kurioje reikėtų apie ją pranešti:

Vieta, kur radote riktą, ar kur norite naujo funkcionalumo

Vieta, kur reikia pranešti

Aplikacijos (QGIS Darbastalis, QGIS Serveris)

https://github.com/qgis/QGIS/issues

QGIS Svetainė (https://qgis.org)

https://github.com/qgis/QGIS-Website/issues

QGIS Dokumentacija (https://docs.qgis.org)

https://github.com/qgis/QGIS-Documentation/issues

C++ API (https://qgis.org/api)

https://github.com/qgis/QGIS/issues

PyQGIS API (https://qgis.org/pyqgis)

https://github.com/qgis/QGIS/issues (for contents) and https://github.com/qgis/pyqgis/issues (for formatting)

Išoriniai priedai

Priedo aprašyme autorių nurodyta repozitorija

Pagalbai ir klausimams naudokite Mailing lists.

Pranešimai apie QGIS aplikacijų riktus

QGIS aplikacijų (QGIS Darbastalio ir QGIS Serverio) problemas rasite Github’e. Norėdami pateikti naują ar pakomentuoti esamą pranešimą, jūs turėsite prisiregistruoti ir prisijungti.

Prieš registruodami problemą

Before filing an issue, verify that you are running the currently supported versions 3.34.4 or 3.36.0 or the development version 3.37 (see also Laidų planas) 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.

Kai esate prisijungę, matysis mygtukas New Issue. Parinkite jį ir sekite instrukcijas.

Prieš siunčiant pranešimą, prašome patikrinti pranešimo formatavimą spaudžiant „Preview“. Venkite keisti esamus pranešimus, nebent dėl rašybos klaidų. Geriau pridėkite papildomų komentarų.

Tinkinimo informacijos sukūrimas

Jei aptikote programos lūžimą, gali būti naudinga pridėti tinkinimo informaciją, nes klaidą gali būti sunku pakartoti kitoje mašinoje.

Linux’e QGIS automatiškai bando naudoti gdb, kad prisijungtu prie lūžtančio proceso ir sukurtų tinkinimo informaciją. Bet kai kurios distribucijos išjungia galimybę jungtis prie tinkinimo informacijos. Tokiu atveju gdb sukuria tik gan beprasmišką pranešimą:

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)

Tokiu atveju jums reikia įjungti parinktį nustatant kernel.yama.ptrace_scope reikšmę 0 faile /etc/sysctl.d/10-ptrace.conf (arba /etc/sysctl.conf, arba kitame faile aplanke /etc/sysctl.d/) ir įvykdyti sysctl -p naudotoju root. Iš naujo pakartojus lūžimą bus sukurta tinkinimo informacija.

Jei negalite pakartoti lūžimo, visgi einamajame aplanke turėtų būti lūžimo informacija, kurią galima analizuoti po to, kai procesas jau užbaigtas. Tai vadinama core (kai kuriose sistemose prie failo pavadinimo pridedamas taškas ir proceso id).

Kai kuriose distribucijose išjungtas ir „core“ failų kūrimas. Tokiu atveju lūžus gaunate tiesiog Aborted, o ne Aborted (core dumped). Tada turite įvykdyti ulimit -c unlimited prieš paleisdami QGIS. Galite įtraukti tai į jūsų .profile, kad šis funkcionalumas būtų visada įjungtas jums prisijungus.

Kad iš core failo sukurtumėte tinkinimo informaciją, paleiskite gdb /kelias/iki//qgis/binary core. Paprastai tai bus /usr/bin/qgis arba /usr/bin/qgis.bin Debian sistemose su įdiegtu GRASS priedu. gdb paleiskite bt, kuris sukurs tinkinimo informaciją.

Išvesties įrašymas Windows

Kasnaktinė versija pakete OSGeo4W (paketas qgis-dev) kuriama su įjungta tinkinimo išvestimi, kad galėtumėte peržiūrėti su DebugView. Jei problemą sunku pakartoti, išvestis gali suteikti kažkiek informacijos apie tai, kur QGIS lūžta.

Problemų pranešimas apie QGIS svetainę ar dokumentaciją

QGIS projektas teikia aktyvią svetainę ir turtingą dokumentaciją. Nepaisant mūsų pastangų, jei rasite pasenusią informaciją, neteisingą ar neaiškų teiginį, arba pasigesite svarbios informacijos, prašome apie nedvejojant tai pranešti.

Didžioji dalis šių dokumentų talpinami ir tvarkomi GitHub repozitorijose, taigi, norėdami pranešti apie riktą ar pateikti pataisymą, jūs turėsite prisijungti prie GitHub paskyros.

Visų pirma sukurkite GitHub paskyrą.

Tada pasirinkite tinkamą repozitoriją:

Patikrinkite, ar apie problemą dar nebuvo pranešta.

Spauskite New Issue, įrašykite pavadinimą ir aiškų problemos aprašymą.

Baigę spauskite Submit new issue.

Pastaba

Kiekvieno puslapio apačioje yra Fix me nuoroda, leidžianti jums patobulinti šį puslapį ir pateikti pakeitimo pasiūlymą.

Ši galimybė teikiama ir dokumentacijos apačioje.

Pranešimai apie priedų problemas

Dauguma QGIS priedų publikuojami oficialioje QGIS Priedų repozitorijoje. Su jais susiję riktų aprašymai ar funkcionalumo prašymai privalo būti atidaromi atitinkamuose priedų riktų valdymo sistemose:

  • Kiekvienam priedui, esančiam QGIS repozitorijoje, jūs rasite jo metaduomenis ir nuorodą į riktų valdymo sistemą. Priešingu atveju perskaitykite priedo dokumentaciją ir raskite atitinkamos riktų sistemos adresą arba kontaktinį programuotojo adresą.

    Jei informacijos nėra, prašome apie tai pranešti Vystytojų sąrašyne.

  • Kitiems priedams mes neturime galimybės suteikti tokios informacijos.

QGIS projekto pataisymo pateikimas

Be problemų pranešimų, jūs taipogi galite padėti spręsti problemas. Problemų sprendimas daromas GitHub’e per pakeitimų siūlymus. Jums reikės padaryti repozitorijos kopiją ir teikti pakeitimų pasiūlymus:

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.