Dejte nám log,
a my to opravíme.

1Co je v logu

SSTV-AF udržuje rotující textový soubor zvaný debug.log ve svém adresáři dat aplikace. Zachytává věci jako:

• Události připojení / odpojení USB a které zařízení CAT se shodovalo
• Pokusy o automatické připojení a případná selhání
• Sériové rámce CAT odeslané do rádia a přijaté z něj
• Změny pásma, frekvence a režimu SSTV
• Události životního cyklu při startu a zastavení aplikace

Je to prostý text, bezpečný ke čtení, a neobsahuje hesla ani API klíče k nahrávání. Viz sekce soukromí níže, pokud si ho chcete projít před sdílením.

2Odemkněte režim ladění

Nejjednodušší způsob, jak stáhnout log, používá ladicí obrazovku v aplikaci — žádný počítač, žádný správce souborů, žádná oprávnění ke složce Android-data. Obrazovka je ve výchozím stavu skrytá a odemknete ji stejně jako vývojářské možnosti Androidu: klepnutím na blok verze sedmkrát.

1. Otevřete kartu Settings v SSTV-AF.
2. Sjeďte úplně dolů — sekce ABOUT.
3. Klepněte na FAQ & Support. Otevře se dialog About, který zobrazuje verzi aplikace a popis začínající "SSTV, made easy."
4. Klepněte na tento text popisu sedmkrát za sebou. Po sedmém klepnutí se režim ladění zapne a přetrvá mezi spuštěními.
5. Zavřete dialog About. V sekci ABOUT se nyní objeví nový řádek Debug, hned pod FAQ & Support.

3Otevřete Debug & sdílejte

Klepněte na nový řádek Debug. Otevře se celoobrazovkový prohlížeč logu, který živě zobrazuje posledních pár set řádků debug.log — obnovuje se každých pár sekund a automaticky roluje dolů.

13:42:01  USB attach: vid=10c4 pid=ea60
13:42:01  autoConnect attempt #1 → SUCCESS
13:42:02  CAT > FE FE 94 E0 03 FD
13:42:02  CAT < FE FE E0 94 03 00 74 04 00 14 FD
13:42:05  band → 20m, freq 14.230 MHz
13:42:18  RX start: VIS 0x3c → Scottie 1
13:42:20  slant est: +0.7 ms/line, corrected

Z horního panelu nástrojů:

Share

Otevře nabídku sdílení Androidu s debug.log přiloženým jako textový soubor (předmět "SSTV-AF debug.log"). Vyberte Gmail, abyste nám ho poslali přímo e-mailem, nebo jakoukoli aplikaci, která zvládá přílohy — Disk, Outlook, Slack, Signal, Telegram, systémová aplikace Soubory, vše funguje.

Clear

Smaže aktuální log. Užitečné, pokud chcete začít načisto před reprodukcí chyby — prostě stiskněte Clear, opusťte dialog, reprodukujte problém, vraťte se a sdílejte. Kratší log nám usnadní vypozorovat relevantní události.

Logcat: ON / OFF

Když je ON, prohlížeč také připojí nedávný výstup logcat z vlastního procesu aplikace — užitečné, když pád nebo zvuková chyba není plně zachycena v debug.log. Ocas logcat jede s vámi, když klepnete na Share.

4Záloha: aplikace Soubory

Pokud se z nějakého důvodu nemůžete dostat k ladicí obrazovce Debug v aplikaci — starý build, odemčení neproběhlo, prostě byste raději použili správce souborů — soubor logu žije také na disku v datové složce aplikace:

/Android/data/radio.ks3ckc.sstvaf/files/debug.log

1. Otevřete aplikaci Soubory (nebo Moje soubory) v telefonu.
2. Přejděte do Interní úložiště → Android → data. Na některých zařízeních Android tuto složku ve výchozím stavu skrývá; klepněte na nabídku se třemi tečkami a zapněte Zobrazit skryté soubory nebo Systémové složky.
3. Otevřete složku balíčku SSTV-AF, pak files. Uvnitř byste měli vidět debug.log.
4. Podržte debug.log a klepněte na Sdílet.

5Záloha: ADB

Pro vývojáře s počítačem a nástrojem adb Androidu:

1. V telefonu zapněte Možnosti pro vývojáře → Ladění USB.
2. Připojte telefon k počítači přes USB, přijměte výzvu k autorizaci ladění.
3. Z terminálu potvrďte, že je telefon viditelný:

   adb devices -l

4. Stáhněte log z datové složky aplikace:

   adb pull /sdcard/Android/data/radio.ks3ckc.sstvaf/files/debug.log .

   U sestav s více zařízeními zamiřte na telefon výslovně pomocí -s <serial>.

6Napište issue

Užitečné hlášení chyby je malé — tři nebo čtyři krátké odstavce stačí. Vzorec, který vždy funguje:

1. Co jste udělali? „Naladil jsem na 14.230, stanice začala vysílat Scottie 1.“ Konkrétní akce v pořadí. Není třeba popisovat aplikaci — jen na co jste klepli.
2. Co jste očekávali, že se stane? „Čekal jsem, že se obrázek vykreslí čistě.“
3. What actually happened? "The image came in slanted and the colors were shifted left." If anything appeared on screen — error toast, frozen UI, a garbled picture — describe it. A screenshot is gold.
4. Jak často? Pokaždé? Jen na jednom režimu? Jen po uspání telefonu? Cokoli, co dokážete přesně určit, zúží hledání.
5. Přiložte log. Stáhněte debug.log hned po reprodukci problému — nejnovější řádky jsou nejužitečnější.

7Šablona issue

Zkopírujte toto do nové issue a vyplňte mezery:

## What happened

(One or two sentences describing the bug)

## Steps to reproduce
1. (First thing you tapped)
2. (Second thing)
3. (...)

## Expected vs. actual

Expected: (what should have happened)
Actual:   (what did happen)

## Environment

- SSTV-AF version: (Settings → About, or the release tag you installed)
- Source:          GitHub APK / built from source
- Android version: (e.g. 14)
- Device:          (e.g. Pixel 8, Samsung S23, etc.)
- Radio:           (e.g. Yaesu FT-891 over USB-C)
- Cable:           (USB-C direct / OTG adapter / brand if relevant)

## Log

(Attach debug.log, or paste the last ~50 lines in a code block.)

8Pokud aplikace spadla

Když SSTV-AF spadne úplně, Android uchovává samostatné hlášení o pádu. Dvě místa, kam se podívat:

• Pokud jste na buildu s hlášením pádů, zapněte jednou anonymní hlášení a my uvidíme zásobníkový výpis automaticky. Přidání „Právě jsem odeslal hlášení o pádu ze zařízení X kolem <čas>“ do issue nám pomůže to spárovat.
• Pokud máte k dispozici ADB, živý systémový log obvykle obsahuje výpis pádu hned po jeho vzniku:

  adb logcat -d > logcat.txt

  Přiložte logcat.txt navíc k debug.log.

9Soukromí

Ladicí log je jen text. Zachytává provozní události aplikace, ne vaše osobní data. Uvidíte řádky jako:

13:42:01 USB attach: vid=10c4 pid=ea60 (Silicon Labs CP210x)
13:42:01 autoConnect attempt #1 → SUCCESS
13:42:02 CAT > FE FE 94 E0 03 FD
13:42:02 CAT < FE FE E0 94 03 00 74 04 00 14 FD
13:42:05 band → 20m, freq 14.230 MHz

Co tam není: API klíče Cloudlog nebo Wavelog, hesla k vašim účtům, fotky, kontakty ani poloha. Vaše značka a lokátor tam jsou, protože identifikují vaši stanici — ale to je stejně veřejná informace pro licencované radioamatéry.

Pokud si ho chcete projít nebo upravit před odesláním, soubor je prostý text UTF-8. Otevře ho jakýkoli textový editor.