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

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

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

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

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

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

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

1. Ανοίξτε την καρτέλα Settings στο SSTV-AF.
2. Κυλήστε ως κάτω — η ενότητα ABOUT.
3. Αγγίξτε FAQ & Support. Ανοίγει ο διάλογος About, δείχνοντας την έκδοση της εφαρμογής και μια περιγραφή που ξεκινά με "SSTV, 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.230 MHz
13:42:18  RX start: VIS 0x3c → Scottie 1
13:42:20  slant est: +0.7 ms/line, corrected

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

Share

Ανοίγει το φύλλο κοινοποίησης του Android με το debug.log συνημμένο ως αρχείο κειμένου (θέμα "SSTV-AF 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/radio.ks3ckc.sstvaf/files/debug.log

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

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

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

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

   adb devices -l

4. Τραβήξτε το log από τον φάκελο δεδομένων της εφαρμογής:

   adb pull /sdcard/Android/data/radio.ks3ckc.sstvaf/files/debug.log .

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

6Γράψτε το issue

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

1. Τι κάνατε; «Συντονίστηκα στους 14.230, ένας σταθμός άρχισε να στέλνει Scottie 1.» Συγκεκριμένες ενέργειες με τη σειρά. Δεν χρειάζεται να περιγράψετε την εφαρμογή — μόνο τι αγγίξατε.
2. Τι περιμένατε να συμβεί; «Περίμενα η εικόνα να ζωγραφιστεί καθαρά.»
3. Τι συνέβη πραγματικά; «Η εικόνα ήρθε λοξή και τα χρώματα ήταν μετατοπισμένα αριστερά.» Αν εμφανίστηκε κάτι στην οθόνη — μήνυμα σφάλματος, παγωμένη διεπαφή, παραμορφωμένο waterfall — περιγράψτε το. Ένα στιγμιότυπο αξίζει χρυσάφι.
4. Πόσο συχνά; Κάθε φορά; Μόνο σε μία λειτουργία; Μόνο αφού κοιμηθεί το τηλέφωνο; Ό,τι μπορείτε να εντοπίσετε στενεύει την αναζήτηση.
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

- SSTV-AF version: (Settings → About, or the release tag you installed)
- Source:          GitHub APK / 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Αν η εφαρμογή κράσαρε

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

• Αν είστε σ’ ένα build με αναφορά κρασαρισμάτων, ενεργοποιήστε μία φορά τις ανώνυμες αναφορές και θα δούμε το 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.230 MHz

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

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