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

1Co jest w logu

FT8AF 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 i częstotliwości
• 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 FT8AF.
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 "FT8, 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.074 MHz
13:42:18  decode: 14 messages in 64 ms
13:42:33  decode: 11 messages in 58 ms

Z górnego paska narzędzi:

Share

Otwiera menu udostępniania Androida z debug.log dołączonym jako plik tekstowy (temat "FT8AF 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:

/Android/data/com.bg7yoz.ft8cn/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 o nazwie com.bg7yoz.ft8cn, 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:

   adb pull /sdcard/Android/data/com.bg7yoz.ft8cn/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ś? „Podłączyłem mój FT-891, dotknąłem CQ na 20m.” Konkretne czynności po kolei. Nie trzeba opisywać aplikacji — tylko to, czego dotknąłeś.
2. Czego się spodziewałeś? „Spodziewałem się, że radio wejdzie na nadawanie, a aplikacja zacznie wysyłać tony na 14.074.”
3. Co się naprawdę stało? „Pasek TX został na LISTENING. Bez PTT, bez tonów.” Jeśli coś pojawiło się na ekranie — toast błędu, zamrożony interfejs, dziwny wodospad — opisz to. Zrzut ekranu jest na wagę złota.
4. Jak często? Za każdym razem? Tylko po uśpieniu telefonu? Tylko na 6m? 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

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

8Jeśli aplikacja się zawiesiła

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

• Jeśli wziąłeś ją z Google Play, włącz raz anonimowe raportowanie awarii, a zobaczymy ślad stosu automatycznie. Nie musisz nic robić — ale 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.074 MHz

Czego tam nie ma: kluczy API Cloudlog lub QRZ, 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.