Hlášení chyb
⚠
Aplikace neodesílá žádné automatické crash reporty a nesbírá telemetrii. Když nám o chybě neřekneš, nikdo se o ní nedozví — zato na to řeknutí máš tlačítko přímo v aplikaci.
Nahlásit chybu z aplikace
Nejkratší cesta je Nastavení → Pomoc a soukromí → Nahlásit chybu. Napíšeš, co
nefungovalo, volitelně jak to zopakovat, a odešleš.
Verzi, systém a model zařízení aplikace doplní sama, takže je nemusíš nikde hledat
a opisovat. Co přesně hlášení obsahuje, vidíš v náhledu, než ho odešleš:
| Část hlášení | Výchozí stav |
|---|---|
| Tvůj popis, číslo hlášení, verze aplikace a systém | vždy |
| Údaje o zařízení a zobrazení — výrobce, model, verze systému, rozlišení, zvětšení textu | zapnuté, jde vypnout |
| Technická diagnostika — očištěný záznam chyb | vypnutá |
| E-mail pro odpověď | nepovinný |
| Snímek obrazovky | nepovinný, vybíráš ho sám |
Písně, knihovny, poznámky ani přílohy se do hlášení nedostanou nikdy.
Místo odeslání můžeš ťuknout na Otevřít e-mail — aplikace otevře tvou poštovní
aplikaci s předvyplněnou zprávou, takže zprávu odešleš sám a vidíš přesně, co odchází.
ℹ
Když chceš k hlášení přiložit soubor — zálohu nebo import, na kterém to padá — jdi cestou e-mailu. Snímek obrazovky přiložíš i při přímém odeslání, ostatní soubory ne.
Záznam chyb v aplikaci
Aplikace si vede vlastní záznam chyb přímo na zařízení. Najdeš ho v Nastavení → Pomoc a soukromí → Záznam chyb:
- 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 sám od sebe nikam neodchází. Je jen na tvém zařízení a do hlášení se přiloží jen tehdy, když to při odesílání zaškrtneš. Když hlásíš pád aplikace, přilož ho — ušetří to spoustu dohadování.
Kde chybu nahlásit
| Kanál | Kdy ho použít |
|---|---|
| Z aplikace — Nastavení → Pomoc a soukromí → Nahlásit chybu | Nejkratší cesta u chyby v aplikaci. Verzi a zařízení doplní sama. |
| Formulář na webu — stránka beta programu | Když zrovna nemáš telefon v ruce, nebo hlásíš chybu na webu. 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álohu nebo problematický import. |
Co do hlášení patří
Vždycky
Když hlásíš z aplikace, první tři řádky doplní sama a tobě zůstanou poslední tři.
| Údaj | Kde ho vezmeš |
|---|---|
| Verze aplikace | Doplní se sama; ručně v Nastavení → O aplikaci |
| Platforma a verze systému | Doplní se sama (Android 14, iOS 17, Windows 11…) |
| Model zařízení | Doplní se sám, pokud údaje o zařízení nevypneš |
| 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 — v hlášení z aplikace ho zapneš zaškrtnutím technické diagnostiky, nebo si ho vyexportuješ v Nastavení → Pomoc a soukromí → Záznam chyb → 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ů se sítí — 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.4.1 (build 19)
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
Odeslané hlášení se zařadí do interní fronty ke zpracování; u hlášení z aplikace si číslo, které vidíš v náhledu, nech — podle něj se hlášení dá najít a na požádání i smazat. 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ů.