Δώστε μας το log,
και μπορούμε να το διορθώσουμε.

1Τι υπάρχει στο log

Το FT8AF διατηρεί ένα κυλιόμενο αρχείο κειμένου που λέγεται debug.log στον κατάλογο δεδομένων της εφαρμογής του. Καταγράφει πράγματα όπως:

• Συμβάντα σύνδεσης / αποσύνδεσης USB και ποια συσκευή CAT ταίριαξε
• Προσπάθειες αυτόματης σύνδεσης και τυχόν αποτυχίες
• Σειριακά πλαίσια CAT που στάλθηκαν στον πομποδέκτη και ελήφθησαν από αυτόν
• Αλλαγές μπάντας και συχνότητας
• Συμβάντα κύκλου ζωής όταν η εφαρμογή ξεκινά και σταματά

Είναι απλό κείμενο, ασφαλές για ανάγνωση, και δεν περιλαμβάνει κωδικούς ή κλειδιά API μεταφόρτωσης. Δείτε την ενότητα απόρρητο παρακάτω αν θέλετε να το ρίξετε μια ματιά πριν το μοιραστείτε.

2Ξεκλειδώστε τη λειτουργία αποσφαλμάτωσης

Ο ευκολότερος τρόπος εξαγωγής του log χρησιμοποιεί μια οθόνη αποσφαλμάτωσης μέσα στην εφαρμογή — χωρίς υπολογιστή, χωρίς διαχειριστή αρχείων, χωρίς δικαιώματα στον φάκελο Android-data. Η οθόνη είναι κρυφή εξ ορισμού και την ξεκλειδώνετε όπως τις επιλογές προγραμματιστή του Android: αγγίζοντας το μπλοκ έκδοσης επτά φορές.

1. Ανοίξτε την καρτέλα Settings στο FT8AF.
2. Κυλήστε ως κάτω — η ενότητα ABOUT.
3. Αγγίξτε FAQ & Support. Ανοίγει ο διάλογος About, δείχνοντας την έκδοση της εφαρμογής και μια περιγραφή που ξεκινά με "FT8, made easy."
4. Αγγίξτε εκείνο το κείμενο περιγραφής επτά φορές στη σειρά. Μετά το έβδομο άγγιγμα, η λειτουργία αποσφαλμάτωσης ενεργοποιείται και παραμένει μεταξύ εκκινήσεων.
5. Κλείστε τον διάλογο About. Μια νέα σειρά Debug εμφανίζεται τώρα στην ενότητα ABOUT, ακριβώς κάτω από το FAQ & Support.

3Ανοίξτε το Debug & μοιραστείτε

Αγγίξτε τη νέα σειρά Debug. Ανοίγει ένα πρόγραμμα προβολής log πλήρους οθόνης, που δείχνει ζωντανά τις τελευταίες λίγες εκατοντάδες γραμμές του debug.log — ανανεώνεται κάθε δύο δευτερόλεπτα και κυλάει αυτόματα στο κάτω μέρος.

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

Από τη γραμμή εργαλείων στην κορυφή:

Share

Ανοίγει το φύλλο κοινοποίησης του Android με το debug.log συνημμένο ως αρχείο κειμένου (θέμα "FT8AF debug.log"). Επιλέξτε Gmail για να μας το στείλετε απευθείας με email, ή οποιαδήποτε εφαρμογή χειρίζεται συνημμένα — Drive, Outlook, Slack, Signal, Telegram, η εφαρμογή Files του συστήματος, όλα λειτουργούν.

Clear

Διαγράφει το τρέχον log. Χρήσιμο αν θέλετε να ξεκινήσετε από καθαρό πριν αναπαράγετε ένα σφάλμα — απλώς πατήστε Clear, βγείτε από τον διάλογο, αναπαράγετε το πρόβλημα, επιστρέψτε και μοιραστείτε. Το πιο σύντομο log μας διευκολύνει να εντοπίσουμε τα σχετικά συμβάντα.

Logcat: ON / OFF

Όταν είναι ON, το πρόγραμμα προβολής προσθέτει επίσης την πρόσφατη έξοδο logcat από την ίδια τη διεργασία της εφαρμογής — χρήσιμο όταν ένα κρασάρισμα ή σφάλμα ήχου δεν καταγράφεται πλήρως στο debug.log. Η ουρά logcat ταξιδεύει μαζί σας όταν αγγίζετε Share.

4Εναλλακτικά: εφαρμογή Files

Αν για κάποιο λόγο δεν μπορείτε να φτάσετε στην οθόνη Debug μέσα στην εφαρμογή — παλιά έκδοση, το ξεκλείδωμα δεν έπιασε, απλώς προτιμάτε τον διαχειριστή αρχείων — το αρχείο log ζει επίσης στον δίσκο στο:

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

1. Ανοίξτε την εφαρμογή Files (ή Τα αρχεία μου) στο τηλέφωνό σας.
2. Πλοηγηθείτε στο Εσωτερικός χώρος → Android → data. Σε ορισμένες συσκευές το Android κρύβει αυτόν τον φάκελο εξ ορισμού· αγγίξτε το μενού τριών τελειών και ενεργοποιήστε Εμφάνιση κρυφών αρχείων ή Φάκελοι συστήματος.
3. Ανοίξτε τον φάκελο με το όνομα com.bg7yoz.ft8cn, μετά files. Θα πρέπει να δείτε το debug.log μέσα.
4. Κρατήστε πατημένο το debug.log και αγγίξτε Κοινοποίηση.

5Εναλλακτικά: ADB

Για προγραμματιστές με υπολογιστή και το εργαλείο adb του Android:

1. Στο τηλέφωνό σας, ενεργοποιήστε Επιλογές προγραμματιστή → Εντοπισμός σφαλμάτων USB.
2. Συνδέστε το τηλέφωνο στον υπολογιστή με USB, αποδεχτείτε το μήνυμα εξουσιοδότησης αποσφαλμάτωσης.
3. Από ένα τερματικό, επιβεβαιώστε ότι το τηλέφωνο είναι ορατό:

   adb devices -l

4. Τραβήξτε το log:

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

   Σε διατάξεις πολλών συσκευών, στοχεύστε το τηλέφωνο ρητά με -s <serial>.

6Γράψτε το issue

Μια χρήσιμη αναφορά σφάλματος είναι μικρή — τρεις ή τέσσερις σύντομες παράγραφοι αρκούν. Το μοτίβο που πάντα δουλεύει:

1. Τι κάνατε; «Σύνδεσα τον FT-891 μου, άγγιξα CQ στους 20m.» Συγκεκριμένες ενέργειες με τη σειρά. Δεν χρειάζεται να περιγράψετε την εφαρμογή — μόνο τι αγγίξατε.
2. Τι περιμένατε να συμβεί; «Περίμενα ο πομποδέκτης να εκπέμψει και η εφαρμογή να αρχίσει να στέλνει τόνους στους 14.074.»
3. Τι συνέβη πραγματικά; «Η λωρίδα TX έμεινε στο LISTENING. Χωρίς PTT, χωρίς τόνους.» Αν εμφανίστηκε κάτι στην οθόνη — μήνυμα σφάλματος, παγωμένη διεπαφή, παράξενο waterfall — περιγράψτε το. Ένα στιγμιότυπο αξίζει χρυσάφι.
4. Πόσο συχνά; Κάθε φορά; Μόνο αφού κοιμηθεί το τηλέφωνο; Μόνο στους 6m; Ό,τι μπορείτε να εντοπίσετε στενεύει την αναζήτηση.
5. Επισυνάψτε το log. Τραβήξτε το debug.log αμέσως μετά την αναπαραγωγή του προβλήματος — οι πιο πρόσφατες γραμμές είναι οι πιο χρήσιμες.

7Πρότυπο issue

Αντιγράψτε αυτό σ’ ένα νέο issue και συμπληρώστε τα κενά:

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

8Αν η εφαρμογή κράσαρε

Όταν το FT8AF κρασάρει εντελώς, το Android κρατά μια ξεχωριστή αναφορά κρασαρίσματος. Δύο μέρη να κοιτάξετε:

• Αν το πήρατε από το Google Play, ενεργοποιήστε μία φορά την ανώνυμη αναφορά κρασαρισμάτων, και θα δούμε το stack trace αυτόματα. Δεν χρειάζεται να κάνετε τίποτα — αλλά το να προσθέσετε «Μόλις έστειλα μια αναφορά κρασαρίσματος από τη συσκευή X γύρω στις <ώρα>» στο issue μας βοηθά να το ταιριάξουμε.
• Αν έχετε διαθέσιμο το ADB, το ζωντανό log συστήματος συνήθως περιέχει το stack trace του κρασαρίσματος αμέσως μετά που συμβαίνει:

  adb logcat -d > logcat.txt

  Επισυνάψτε το logcat.txt επιπλέον του debug.log.

9Απόρρητο

Το log αποσφαλμάτωσης είναι απλώς κείμενο. Καταγράφει τα συμβάντα λειτουργίας της εφαρμογής, όχι τα προσωπικά σας δεδομένα. Θα δείτε γραμμές όπως:

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

Τι δεν υπάρχει εκεί μέσα: κλειδιά API Cloudlog ή QRZ, κωδικοί των λογαριασμών σας, φωτογραφίες, επαφές ή τοποθεσία. Το callsign και το locator σας είναι εκεί, αφού ταυτοποιούν τον σταθμό σας — αλλά αυτά είναι ούτως ή άλλως δημόσια πληροφορία για τους αδειοδοτημένους ραδιοερασιτέχνες.

Αν θέλετε να το ρίξετε μια ματιά ή να λογοκρίνετε πριν στείλετε, το αρχείο είναι απλό κείμενο UTF-8. Οποιοσδήποτε επεξεργαστής κειμένου θα το ανοίξει.