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

1Co je v logu

FT8AF 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 a frekvence
• 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 FT8AF.
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í "FT8, 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.074 MHz
13:42:18  decode: 14 messages in 64 ms
13:42:33  decode: 11 messages in 58 ms

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 "FT8AF 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:

/Android/data/com.bg7yoz.ft8cn/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 s názvem com.bg7yoz.ft8cn, pak files. Měli byste uvnitř 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:

   adb pull /sdcard/Android/data/com.bg7yoz.ft8cn/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? „Zapojil jsem svůj FT-891, klepl na CQ na 20m.“ 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 rádio přejde na vysílání a aplikace začne posílat tóny na 14.074.“
3. Co se ve skutečnosti stalo? „Pruh TX zůstal na LISTENING. Žádné PTT, žádné tóny.“ Pokud se na obrazovce něco objevilo — chybový toast, zamrzlé rozhraní, divný vodopád — popište to. Snímek obrazovky je k nezaplacení.
4. Jak často? Pokaždé? Jen po uspání telefonu? Jen na 6m? 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

- FT8AF version:   (Settings → About, or the release tag you installed)
- Source:          GitHub APK / Google Play / 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ž FT8AF spadne úplně, Android uchovává samostatné hlášení o pádu. Dvě místa, kam se podívat:

• Pokud jste ji dostali z Google Play, zapněte jednou anonymní hlášení o pádech a my uvidíme zásobníkový výpis automaticky. Nemusíte nic dělat — ale 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 zásobníkový 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.074 MHz

Co tam není: API klíče Cloudlog nebo QRZ, 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.