Passez-nous le journal,
et on pourra le corriger.

1Ce qu'il y a dans le journal

FT8AF tient un fichier texte tournant nommé debug.log dans son répertoire de données d'app. Il capture des choses comme :

• Événements de connexion / déconnexion USB et quel périphérique CAT a correspondu
• Tentatives de connexion automatique et leurs échecs éventuels
• Trames série CAT envoyées et reçues du poste
• Changements de bande et de fréquence
• Événements de cycle de vie au démarrage et à l'arrêt de l'app

C'est du texte brut, sûr à lire, et il n'inclut ni mots de passe ni clés API d'envoi. Voir la section confidentialité ci-dessous si vous voulez le survoler avant de le partager.

2Débloquez le mode débogage

Le plus simple pour récupérer le journal utilise un écran de débogage dans l'app — sans ordinateur, sans gestionnaire de fichiers, sans permissions du dossier Android-data. L'écran est caché par défaut et vous le débloquez comme les options développeur d'Android : en touchant le bloc de version sept fois.

1. Ouvrez l'onglet Settings dans FT8AF.
2. Descendez tout en bas — la section ABOUT.
3. Touchez FAQ & Support. La boîte de dialogue About s'ouvre, montrant la version de l'app et une description commençant par "FT8, made easy."
4. Touchez ce texte de description sept fois de suite. Après le septième toucher, le mode débogage s'active et persiste entre les lancements.
5. Fermez la boîte de dialogue About. Une nouvelle ligne Debug apparaît maintenant dans la section ABOUT, juste sous FAQ & Support.

3Ouvrez Debug & partagez

Touchez la nouvelle ligne Debug. Un visualiseur de journal plein écran s'ouvre, affichant en direct les dernières centaines de lignes de debug.log — il se rafraîchit toutes les deux secondes et défile automatiquement vers le bas.

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

Depuis la barre d'outils du haut :

Share

Ouvre le menu de partage d'Android avec debug.log joint en fichier texte (objet "FT8AF debug.log"). Choisissez Gmail pour nous l'envoyer directement par e-mail, ou toute app qui gère les pièces jointes — Drive, Outlook, Slack, Signal, Telegram, l'app Fichiers du système, tout marche.

Clear

Supprime le journal actuel. Utile si vous voulez repartir de zéro avant de reproduire un bug — pressez simplement Clear, quittez la boîte de dialogue, reproduisez le problème, revenez et partagez. Le journal plus court facilite le repérage des événements pertinents.

Logcat: ON / OFF

Quand c'est ON, le visualiseur ajoute aussi la sortie logcat récente du propre processus de l'app — utile quand un plantage ou un bug audio n'est pas entièrement capturé dans debug.log. La queue logcat part avec quand vous touchez Share.

4Solution de repli : app Fichiers

Si pour une raison quelconque vous ne pouvez pas atteindre l'écran Debug dans l'app — version ancienne, le déblocage n'a pas pris, vous préférez simplement le gestionnaire de fichiers — le fichier de journal vit aussi sur le disque à :

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

1. Ouvrez l'app Fichiers (ou Mes fichiers) sur votre téléphone.
2. Naviguez jusqu'à Stockage interne → Android → data. Sur certains appareils, Android cache ce dossier par défaut ; touchez le menu à trois points et activez Afficher les fichiers cachés ou Dossiers système.
3. Ouvrez le dossier nommé com.bg7yoz.ft8cn, puis files. Vous devriez voir debug.log à l'intérieur.
4. Appui long sur debug.log et touchez Partager.

5Solution de repli : ADB

Pour les développeurs avec un ordinateur et l'outil adb d'Android :

1. Sur votre téléphone, activez Options développeur → Débogage USB.
2. Branchez le téléphone à l'ordinateur en USB, acceptez l'invite d'autorisation de débogage.
3. Depuis un terminal, confirmez que le téléphone est visible :

   adb devices -l

4. Récupérez le journal :

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

   Sur les montages à plusieurs appareils, ciblez le téléphone explicitement avec -s <serial>.

6Écrivez le ticket

Un bon rapport de bug est court — trois ou quatre courts paragraphes suffisent largement. Le schéma qui marche toujours :

1. Qu'avez-vous fait ? « J'ai branché mon FT-891, touché CQ sur 20m. » Des actions concrètes dans l'ordre. Pas besoin de décrire l'app — juste ce que vous avez touché.
2. Qu'attendiez-vous ? « Je m'attendais à ce que le poste passe en émission et que l'app commence à envoyer des tonalités sur 14.074. »
3. Que s'est-il réellement passé ? « Le bandeau TX est resté sur LISTENING. Pas de PTT, pas de tonalités. » Si quelque chose est apparu à l'écran — toast d'erreur, interface figée, waterfall bizarre — décrivez-le. Une capture vaut de l'or.
4. À quelle fréquence ? À chaque fois ? Seulement après la mise en veille du téléphone ? Seulement sur 6m ? Tout ce que vous pouvez cerner réduit la recherche.
5. Joignez le journal. Récupérez debug.log juste après avoir reproduit le problème — les lignes les plus récentes sont les plus utiles.

7Modèle de ticket

Copiez ceci dans un nouveau ticket et remplissez les blancs :

## 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 l'app a planté

Quand FT8AF plante d'un coup, Android conserve un rapport de plantage à part. Deux endroits où regarder :

• Si vous l'avez eue par Google Play, activez une fois le rapport de plantage anonyme et nous verrons la trace de pile automatiquement. Vous n'avez rien à faire — mais ajouter « Je viens d'envoyer un rapport de plantage depuis l'appareil X vers <heure> » au ticket nous aide à le rapprocher.
• Si vous avez ADB disponible, le journal système en direct contient généralement la trace du plantage juste après qu'il survient :

  adb logcat -d > logcat.txt

  Joignez logcat.txt en plus de debug.log.

9Confidentialité

Le journal de débogage n'est que du texte. Il capture les événements d'opération de l'app, pas vos données personnelles. Vous verrez des lignes comme :

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

Ce qui n'y est pas : clés API Cloudlog ou QRZ, mots de passe de vos comptes, photos, contacts ou localisation. Votre indicatif et votre locator y sont, puisqu'ils identifient votre station — mais ce sont de toute façon des informations publiques pour les radioamateurs licenciés.

Si vous voulez survoler ou caviarder avant d'envoyer, le fichier est du texte brut UTF-8. N'importe quel éditeur de texte l'ouvrira.