Passaci il log,
e possiamo sistemarlo.

1Cosa c'è nel log

FT8AF mantiene un file di testo rotante chiamato debug.log nella sua cartella dati dell'app. Cattura cose come:

• Eventi di connessione / disconnessione USB e quale dispositivo CAT ha corrisposto
• Tentativi di connessione automatica ed eventuali fallimenti
• Frame seriali CAT inviati e ricevuti dalla radio
• Cambi di banda e di frequenza
• Eventi del ciclo di vita all'avvio e all'arresto dell'app

È testo semplice, sicuro da leggere, e non include password né chiavi API di caricamento. Vedi la sezione privacy qui sotto se vuoi scorrerlo prima di condividerlo.

2Sblocca la modalità debug

Il modo più facile per estrarre il log usa una schermata di debug dentro l'app — niente computer, niente file manager, niente permessi sulla cartella Android-data. La schermata è nascosta per default e la sblocchi come le opzioni sviluppatore di Android: toccando il blocco della versione sette volte.

1. Apri la scheda Settings in FT8AF.
2. Scorri fino in fondo — la sezione ABOUT.
3. Tocca FAQ & Support. Si apre la finestra About, che mostra la versione dell'app e una descrizione che inizia con "FT8, made easy."
4. Tocca quel testo di descrizione sette volte di fila. Dopo il settimo tocco, la modalità debug si attiva e persiste tra gli avvii.
5. Chiudi la finestra About. Ora appare una nuova riga Debug nella sezione ABOUT, proprio sotto FAQ & Support.

3Apri Debug & condividi

Tocca la nuova riga Debug. Si apre un visualizzatore di log a schermo intero, che mostra in tempo reale le ultime centinaia di righe di debug.log — si aggiorna ogni paio di secondi e scorre automaticamente in fondo.

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

Dalla barra in alto:

Share

Apre il menu di condivisione di Android con debug.log allegato come file di testo (oggetto "FT8AF debug.log"). Scegli Gmail per inviarcelo direttamente via email, o qualsiasi app che gestisca gli allegati — Drive, Outlook, Slack, Signal, Telegram, l'app File di sistema, funzionano tutte.

Clear

Elimina il log attuale. Utile se vuoi ripartire da zero prima di riprodurre un bug — premi semplicemente Clear, esci dalla finestra, riproduci il problema, torna e condividi. Il log più corto rende più facile individuare gli eventi rilevanti.

Logcat: ON / OFF

Quando è ON, il visualizzatore aggiunge anche l'output recente di logcat del processo dell'app — utile quando un crash o un bug audio non è del tutto catturato in debug.log. La coda di logcat viaggia con te quando tocchi Share.

4Ripiego: app File

Se per qualche motivo non riesci ad arrivare alla schermata Debug nell'app — versione vecchia, lo sblocco non ha funzionato, preferisci semplicemente il file manager — il file di log vive anche su disco in:

/Android/data/com.bg7yoz.ft8cn/files/debug.log

1. Apri l'app File (o I miei file) sul telefono.
2. Vai a Memoria interna → Android → data. Su alcuni dispositivi Android nasconde questa cartella per default; tocca il menu a tre punti e attiva Mostra file nascosti o Cartelle di sistema.
3. Apri la cartella chiamata com.bg7yoz.ft8cn, poi files. Dovresti vedere debug.log dentro.
4. Tieni premuto debug.log e tocca Condividi.

5Ripiego: ADB

Per gli sviluppatori con un computer e lo strumento adb di Android:

1. Sul telefono, attiva Opzioni sviluppatore → Debug USB.
2. Collega il telefono al computer via USB, accetta l'avviso di autorizzazione al debug.
3. Da un terminale, conferma che il telefono sia visibile:

   adb devices -l

4. Estrai il log:

   adb pull /sdcard/Android/data/com.bg7yoz.ft8cn/files/debug.log .

   Su configurazioni con più dispositivi, punta al telefono esplicitamente con -s <serial>.

6Scrivi la issue

Una buona segnalazione di bug è breve — tre o quattro paragrafi corti bastano. Lo schema che funziona sempre:

1. Cosa hai fatto? "Ho collegato il mio FT-891, toccato CQ su 20m." Azioni concrete in ordine. Non serve descrivere l'app — solo cosa hai toccato.
2. Cosa ti aspettavi che succedesse? "Mi aspettavo che la radio andasse in trasmissione e l'app iniziasse a inviare toni su 14.074."
3. Cosa è successo davvero? "La striscia TX è rimasta su LISTENING. Nessun PTT, nessun tono." Se è apparso qualcosa a schermo — toast di errore, interfaccia bloccata, waterfall strano — descrivilo. Uno screenshot vale oro.
4. Con che frequenza? Ogni volta? Solo dopo che il telefono va in standby? Solo su 6m? Tutto ciò che riesci a circoscrivere riduce la ricerca.
5. Allega il log. Estrai debug.log subito dopo aver riprodotto il problema — le righe più recenti sono le più utili.

7Modello di issue

Copia questo in una nuova issue e riempi gli spazi:

## 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.)

8Se l'app è andata in crash

Quando FT8AF va in crash di colpo, Android conserva un rapporto di crash a parte. Due posti dove guardare:

• Se l'hai presa da Google Play, attiva una volta il rapporto di crash anonimo e vedremo lo stack trace automaticamente. Non devi fare nulla — ma aggiungere "Ho appena inviato un rapporto di crash dal dispositivo X intorno alle <ora>" alla issue ci aiuta ad abbinarlo.
• Se hai ADB disponibile, il log di sistema in tempo reale di solito contiene lo stack trace del crash subito dopo che avviene:

  adb logcat -d > logcat.txt

  Allega logcat.txt oltre a debug.log.

9Privacy

Il log di debug è solo testo. Cattura gli eventi operativi dell'app, non i tuoi dati personali. Vedrai righe come:

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

Ciò che non c'è dentro: chiavi API di Cloudlog o QRZ, password dei tuoi account, foto, contatti o posizione. Il tuo nominativo e il tuo locatore ci sono, dato che identificano la tua stazione — ma sono comunque informazioni pubbliche per i radioamatori con licenza.

Se vuoi scorrerlo o oscurare qualcosa prima di inviarlo, il file è testo semplice UTF-8. Qualsiasi editor di testo lo aprirà.