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. Co se ve skutečnosti stalo? „Obrázek přišel nakloněný a barvy byly posunuté doleva.“ Pokud se na obrazovce něco objevilo — chybový toast, zamrzlé rozhraní, rozházený vodopád — popište to. Snímek obrazovky je k nezaplacení.
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.