Pásanos el registro,
y podremos arreglarlo.

1Qué hay en el registro

FT8AF mantiene un archivo de texto rotativo llamado debug.log en su directorio de datos de la app. Captura cosas como:

• Eventos de conexión / desconexión USB y qué dispositivo CAT coincidió
• Intentos de autoconexión y cualquier fallo
• Tramas serie CAT enviadas y recibidas del equipo
• Cambios de banda y de frecuencia
• Eventos de ciclo de vida cuando la app arranca y se detiene

Es texto plano, seguro de leer, y no incluye contraseñas ni claves API de subida. Consulta la sección de privacidad de abajo si quieres echarle un vistazo antes de compartirlo.

2Desbloquea el modo depuración

La forma más fácil de extraer el registro usa una pantalla de depuración dentro de la app — sin ordenador, sin gestor de archivos, sin permisos de la carpeta Android-data. La pantalla está oculta por defecto y la desbloqueas igual que las opciones de desarrollador de Android: tocando el bloque de versión siete veces.

1. Abre la pestaña Settings en FT8AF.
2. Baja hasta el final — la sección ABOUT.
3. Toca FAQ & Support. Se abre el diálogo About, mostrando la versión de la app y una descripción que empieza con "FT8, made easy."
4. Toca ese texto de descripción siete veces seguidas. Tras el séptimo toque, el modo depuración se activa y persiste entre arranques.
5. Cierra el diálogo About. Ahora aparece una nueva fila Debug en la sección ABOUT, justo bajo FAQ & Support.

3Abre Debug & comparte

Toca la nueva fila Debug. Se abre un visor de registro a pantalla completa, mostrando en vivo las últimas cientos de líneas de debug.log — se refresca cada par de segundos y se desplaza solo al final.

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

Desde la barra superior:

Share

Abre el menú de compartir de Android con debug.log adjunto como archivo de texto (asunto "FT8AF debug.log"). Elige Gmail para enviárnoslo directamente por correo, o cualquier app que maneje archivos adjuntos — Drive, Outlook, Slack, Signal, Telegram, la app Archivos del sistema, todos funcionan.

Clear

Borra el registro actual. Útil si quieres empezar de cero antes de reproducir un error — solo pulsa Clear, sal del diálogo, reproduce el problema, vuelve y comparte. El registro más corto facilita que detectemos los eventos relevantes.

Logcat: ON / OFF

Cuando está en ON, el visor también añade la salida reciente de logcat del propio proceso de la app — útil cuando un cierre o un error de audio no queda del todo capturado en debug.log. La cola de logcat viaja contigo al tocar Share.

4Alternativa: app de Archivos

Si por algún motivo no puedes llegar a la pantalla Debug dentro de la app — versión antigua, el desbloqueo no funcionó, simplemente prefieres usar el gestor de archivos — el archivo de registro también vive en disco en:

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

1. Abre la app Archivos (o Mis archivos) en tu teléfono.
2. Navega a Almacenamiento interno → Android → data. En algunos dispositivos Android oculta esta carpeta por defecto; toca el menú de tres puntos y activa Mostrar archivos ocultos o Carpetas del sistema.
3. Abre la carpeta llamada com.bg7yoz.ft8cn, luego files. Deberías ver debug.log dentro.
4. Mantén pulsado debug.log y toca Compartir.

5Alternativa: ADB

Para desarrolladores con un ordenador y la herramienta adb de Android:

1. En tu teléfono, activa Opciones de desarrollador → Depuración por USB.
2. Conecta el teléfono al ordenador por USB, acepta el aviso de autorización de depuración.
3. Desde un terminal, confirma que el teléfono es visible:

   adb devices -l

4. Extrae el registro:

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

   En montajes con varios dispositivos, apunta al teléfono explícitamente con -s <serial>.

6Escribe la incidencia

Un buen informe de error es breve — tres o cuatro párrafos cortos bastan. El patrón que siempre funciona:

1. ¿Qué hiciste? "Conecté mi FT-891, toqué CQ en 20m." Acciones concretas en orden. No hace falta describir la app — solo lo que tocaste.
2. ¿Qué esperabas que pasara? "Esperaba que el equipo diera PTT y la app empezara a enviar tonos en 14.074."
3. ¿Qué pasó en realidad? "La franja de TX se quedó en LISTENING. Sin PTT, sin tonos." Si apareció algo en pantalla — aviso de error, interfaz congelada, cascada rara — descríbelo. Una captura vale oro.
4. ¿Con qué frecuencia? ¿Siempre? ¿Solo tras dormir el teléfono? ¿Solo en 6m? Lo que puedas concretar reduce la búsqueda.
5. Adjunta el registro. Extrae debug.log justo después de reproducir el problema — las líneas más recientes son las más útiles.

7Plantilla de incidencia

Copia esto en una incidencia nueva y rellena los huecos:

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

8Si la app se cerró

Cuando FT8AF se cierra de golpe, Android guarda un informe de fallo aparte. Dos sitios donde mirar:

• Si la conseguiste por Google Play, activa una vez el reporte anónimo de fallos y veremos la traza de pila automáticamente. No tienes que hacer nada — pero añadir "Acabo de enviar un informe de fallo desde el dispositivo X sobre las <hora>" a la incidencia nos ayuda a cuadrarlo.
• Si tienes ADB disponible, el registro del sistema en vivo suele contener la traza del fallo justo después de que ocurra:

  adb logcat -d > logcat.txt

  Adjunta logcat.txt además de debug.log.

9Privacidad

El registro de depuración es solo texto. Captura los eventos de operación de la app, no tus datos personales. Verás líneas como:

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

Lo que no hay ahí: claves API de Cloudlog o QRZ, contraseñas de tus cuentas, fotos, contactos o ubicación. Tu indicativo y tu localizador sí están ahí, ya que identifican tu estación — pero esos son información pública para los radioaficionados con licencia de todos modos.

Si quieres echar un vistazo o censurar algo antes de enviarlo, el archivo es texto plano UTF-8. Cualquier editor de texto lo abrirá.