Hlášení chyb
⚠
Aplikace neodesílá žádné automatické crash reporty. Nesbírá se telemetrie. Když nám o chybě neřekneš, nikdo se o ní nedozví.
Záznam chyb v aplikaci
Aplikace si od verze 0.2.3 vede vlastní záznam chyb přímo na zařízení. Najdeš ho v Nastavení → Diagnostika:
- Zobrazit — seznam zachycených chyb s časem
- Uložit soubor — vyexportuje záznam jako textový soubor
- Vymazat — záznam vyprázdní
Opakující se chyba se zapíše jen třikrát a pak se zahazuje, aby jeden problém nezaplavil celý záznam.
ℹ
Záznam nikam neodchází. Je jen na tvém zařízení a rozhoduješ ty, jestli ho pošleš. Když hlásíš pád, přilož ho — ušetří to spoustu dohadování.
Kde chybu nahlásit
| Kanál | Kdy ho použít |
|---|---|
| Formulář na webu — stránka beta programu | Standardní cesta. Má připravená pole, takže na nic nezapomeneš. |
| Discord | Když si nejsi jistý, jestli jde o chybu, nebo chceš rychle poradit. |
| E-mail — [email protected] | Když potřebuješ přiložit soubor — záznam chyb, zálohu nebo problematický import. |
Co do hlášení patří
Vždycky
| Údaj | Kde ho vezmeš |
|---|---|
| Verze aplikace | Nastavení → O aplikaci (číslo verze i build) |
| Platforma a verze systému | Android 14, iOS 17, Windows 11… |
| Model zařízení | Hlavně u méně obvyklých telefonů a tabletů |
| Co jsi dělal | Kroky, které k chybě vedly, po jednom |
| Co jsi čekal | Jak se to podle tebe mělo chovat |
| Co se stalo | Co se stalo místo toho |
Když to jde
- Záznam chyb z Nastavení → Diagnostika → Uložit soubor — u pádů je to nejcennější příloha
- Snímek obrazovky nebo krátké video — u vizuálních chyb ušetří půl hodiny psaní
- Přesné znění chybové hlášky — chybové stavy synchronizace jsou pojmenované, takže z hlášky se pozná, kde to spadlo
- Soubor, který problém způsobil — u chyb importu je to prakticky nutnost
- Jestli se to opakuje — pokaždé, nebo jen občas?
Chyby synchronizace
Sync je nejsložitější část aplikace a zároveň ta, u které nejvíc záleží na prostředí. U problémů se synchronizací připoj navíc:
- Obě zařízení — platforma, verze systému a verze aplikace u leadera i u člena
- Typ sítě — domácí WiFi, hotspot z telefonu, klubová síť, veřejná WiFi
- Roli — bylo tvoje zařízení leader, nebo člen?
- Ve které fázi to selhalo — nenašlo se, nepřipojilo se, připojilo se a spadlo, nebo se nepřenesla data?
- Chybovou hlášku doslova
Než chybu nahlásíš, projdi si prosím řešení problémů u mDNS — velká část potíží se sítí se dá vyřešit rovnou a ušetří to čas oběma stranám.
Příklad dobrého hlášení
text
Verze: 0.2.7 (build 10)
Zařízení: Samsung Galaxy Tab A8, Android 13
Role: člen
Kroky:
1. Leader (iPhone 13, iOS 17) spustil relaci na domácí WiFi
2. Na tabletu jsem naskenoval QR kód
3. Připojení proběhlo, viděl jsem seznam členů
4. Leader přepnul píseň
Očekával jsem: přepnutí na stejnou píseň
Stalo se: tablet zůstal na původní písni, po ~20 s se objevila
hláška "Leader se odpojil"
Opakuje se: pokaždé, když je tablet víc než 2 minuty v relaci.
Na jiné WiFi se to nestalo.
Z takového hlášení se dá vyjít i bez dalších dotazů — je v něm verze, obě zařízení, síť, reprodukční kroky i pozorování, které chybu zužuje.
Co se s hlášením děje
Hlášení odeslané formulářem se zařadí do interní fronty ke zpracování. Přednost dostávají chyby v tomhle pořadí:
- Ztráta dat — cokoli, co maže nebo poškozuje knihovnu
- Pád aplikace nebo stav, ze kterého není cesta ven
- Nefunkční synchronizace na běžné síti
- Nefunkční hlavní scénář — import, export, živý režim
- Kosmetické a drobné chyby
Co se s odeslanými údaji děje z pohledu ochrany osobních údajů, popisují Zásady ochrany osobních údajů.