Daj nam log,
a możemy to naprawić.

1Co jest w logu

SSTV-AF utrzymuje rotacyjny plik tekstowy o nazwie debug.log w swoim katalogu danych aplikacji. Przechwytuje rzeczy takie jak:

• Zdarzenia podłączenia / odłączenia USB i które urządzenie CAT pasowało
• Próby automatycznego łączenia i ewentualne niepowodzenia
• Ramki szeregowe CAT wysłane do radia i odebrane z niego
• Zmiany pasma, częstotliwości i trybu SSTV
• Zdarzenia cyklu życia przy starcie i zatrzymaniu aplikacji

To zwykły tekst, bezpieczny do odczytu, i nie zawiera haseł ani kluczy API wysyłki. Zobacz sekcję prywatność poniżej, jeśli chcesz przejrzeć go przed udostępnieniem.

2Odblokuj tryb debugowania

Najłatwiejszy sposób na pobranie logu wykorzystuje ekran debugowania w aplikacji — bez komputera, bez menedżera plików, bez uprawnień do folderu Android-data. Ekran jest domyślnie ukryty i odblokowujesz go tak samo jak opcje programisty Androida: dotykając bloku wersji siedem razy.

1. Otwórz zakładkę Settings w SSTV-AF.
2. Przewiń na sam dół — sekcja ABOUT.
3. Dotknij FAQ & Support. Otwiera się okno About, pokazujące wersję aplikacji i opis zaczynający się od "SSTV, made easy."
4. Dotknij tego tekstu opisu siedem razy z rzędu. Po siódmym dotknięciu tryb debugowania włącza się i utrzymuje między uruchomieniami.
5. Zamknij okno About. W sekcji ABOUT pojawia się teraz nowy wiersz Debug, tuż pod FAQ & Support.

3Otwórz Debug & udostępnij

Dotknij nowego wiersza Debug. Otwiera się pełnoekranowa przeglądarka logu, pokazująca na żywo ostatnie kilkaset linii debug.log — odświeża się co kilka sekund i automatycznie przewija na dół.

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

Z górnego paska narzędzi:

Share

Otwiera menu udostępniania Androida z debug.log dołączonym jako plik tekstowy (temat "SSTV-AF debug.log"). Wybierz Gmail, by wysłać nam go bezpośrednio mailem, albo dowolną aplikację obsługującą załączniki — Dysk, Outlook, Slack, Signal, Telegram, systemowa aplikacja Pliki, wszystkie działają.

Clear

Usuwa bieżący log. Przydatne, jeśli chcesz zacząć od czysta przed odtworzeniem błędu — po prostu naciśnij Clear, wyjdź z okna, odtwórz problem, wróć i udostępnij. Krótszy log ułatwia nam wypatrzenie istotnych zdarzeń.

Logcat: ON / OFF

Gdy ON, przeglądarka dołącza też ostatnie wyjście logcat z własnego procesu aplikacji — przydatne, gdy awaria lub błąd audio nie jest w pełni uchwycony w debug.log. Ogon logcat jedzie z Tobą, gdy dotkniesz Share.

4Awaryjnie: aplikacja Pliki

Jeśli z jakiegoś powodu nie możesz dostać się do ekranu Debug w aplikacji — stary build, odblokowanie nie zadziałało, po prostu wolisz menedżer plików — plik logu żyje też na dysku w folderze danych aplikacji:

/Android/data/radio.ks3ckc.sstvaf/files/debug.log

1. Otwórz aplikację Pliki (lub Moje pliki) na telefonie.
2. Przejdź do Pamięć wewnętrzna → Android → data. Na niektórych urządzeniach Android domyślnie ukrywa ten folder; dotknij menu z trzema kropkami i włącz Pokaż ukryte pliki lub Foldery systemowe.
3. Otwórz folder pakietu SSTV-AF, potem files. Powinieneś zobaczyć debug.log w środku.
4. Przytrzymaj debug.log i dotknij Udostępnij.

5Awaryjnie: ADB

Dla programistów z komputerem i narzędziem adb Androida:

1. Na telefonie włącz Opcje programisty → Debugowanie USB.
2. Podłącz telefon do komputera przez USB, zaakceptuj monit o autoryzację debugowania.
3. Z terminala potwierdź, że telefon jest widoczny:

   adb devices -l

4. Pobierz log z folderu danych aplikacji:

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

   Przy zestawach z wieloma urządzeniami wskaż telefon jawnie przez -s <serial>.

6Napisz zgłoszenie

Użyteczne zgłoszenie błędu jest małe — trzy lub cztery krótkie akapity wystarczą. Schemat, który zawsze działa:

1. Co zrobiłeś? „Dostroiłem się na 14.230, stacja zaczęła nadawać Scottie 1.” Konkretne czynności po kolei. Nie trzeba opisywać aplikacji — tylko to, czego dotknąłeś.
2. Czego się spodziewałeś? „Spodziewałem się, że obraz narysuje się czysto.”
3. Co się naprawdę stało? „Obraz przyszedł przechylony, a kolory były przesunięte w lewo.” Jeśli coś pojawiło się na ekranie — toast błędu, zamrożony interfejs, zniekształcony wodospad — opisz to. Zrzut ekranu jest na wagę złota.
4. Jak często? Za każdym razem? Tylko na jednym trybie? Tylko po uśpieniu telefonu? Wszystko, co zdołasz uściślić, zawęża poszukiwania.
5. Dołącz log. Pobierz debug.log tuż po odtworzeniu problemu — najnowsze linie są najbardziej przydatne.

7Szablon zgłoszenia

Skopiuj to do nowego zgłoszenia i wypełnij luki:

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

8Jeśli aplikacja się zawiesiła

Gdy SSTV-AF zawiesi się całkowicie, Android przechowuje osobny raport awarii. Dwa miejsca do sprawdzenia:

• Jeśli jesteś na buildzie z raportowaniem awarii, włącz raz anonimowe raporty, a zobaczymy ślad stosu automatycznie. Dodanie „Właśnie wysłałem raport awarii z urządzenia X około <czas>” do zgłoszenia pomaga nam to dopasować.
• Jeśli masz dostępne ADB, log systemowy na żywo zwykle zawiera ślad awarii tuż po jej wystąpieniu:

  adb logcat -d > logcat.txt

  Dołącz logcat.txt oprócz debug.log.

9Prywatność

Log debugowania to tylko tekst. Przechwytuje zdarzenia operacyjne aplikacji, nie Twoje dane osobowe. Zobaczysz linie takie jak:

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

Czego tam nie ma: kluczy API Cloudlog lub Wavelog, haseł Twoich kont, zdjęć, kontaktów ani lokalizacji. Twój znak i lokator tam są, bo identyfikują Twoją stację — ale to i tak informacja publiczna dla licencjonowanych krótkofalowców.

Jeśli chcesz przejrzeć lub ocenzurować przed wysłaniem, plik to zwykły tekst UTF-8. Otworzy go dowolny edytor tekstu.