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
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ą

Prieš registruodami problemą peržiūrėkite atviras problemas, kad įsitikintumėte, jog nekuriate pranešimo pakartotinai. Jei turite papildomos informacijos apie problemą, galite ją pridėti prie esamo pranešimo. Trečiųjų šalių priedai taipogi gali sukelti problemų. Jei esate jų įdiegę, turėtumėte patikrinti, kad problema pasikartoja ir be priedų. Prašome nepranešinėti apie kelis nesusijusius riktus viename pranešime.

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:

Patarimų kaip lengvai pateikti pokyčius QGIS projektams rasite submit_patch. O plačiau galite paskaityti git_access.