Дайте нам лог,
і ми зможемо це виправити.

1Що в лозі

FT8AF веде ротований текстовий файл під назвою debug.log у каталозі даних свого застосунку. Він захоплює такі речі, як:

• Події під’єднання / від’єднання USB і який пристрій CAT збігся
• Спроби автопід’єднання та будь-які збої
• Послідовні кадри CAT, надіслані трансиверу й отримані від нього
• Зміни діапазону й частоти
• Події життєвого циклу при запуску й зупинці застосунку

Це простий текст, безпечний для читання, і він не містить паролів чи ключів API завантаження. Дивіться розділ конфіденційність нижче, якщо хочете пробігтися по ньому, перш ніж ділитися.

2Розблокуйте режим налагодження

Найпростіший спосіб вилучити лог використовує екран налагодження всередині застосунку — без комп’ютера, без файлового менеджера, без дозволів на папку 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. Відкриється повноекранний переглядач лога, що показує наживо останні кілька сотень рядків 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

Видаляє поточний лог. Корисно, якщо хочете почати з чистого аркуша перед відтворенням бага — просто натисніть Clear, вийдіть із діалогу, відтворіть проблему, поверніться й поділіться. Коротший лог полегшує нам знаходження значущих подій.

Logcat: ON / OFF

Коли ON, переглядач також додає недавній вивід logcat із власного процесу застосунку — корисно, коли збій чи баг звуку не повністю захоплено в debug.log. Хвіст logcat їде з вами, коли ви торкаєтеся Share.

4Запасний шлях: застосунок Files

Якщо з якоїсь причини ви не можете дістатися до екрана Debug усередині застосунку — стара збірка, розблокування не спрацювало, ви просто віддаєте перевагу файловому менеджеру — файл лога також живе на диску за адресою:

/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. Вилучіть лог:

   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, без тонів.» Якщо щось з’явилося на екрані — спливне повідомлення про помилку, завислий інтерфейс, дивний водоспад — опишіть це. Знімок екрана — на вагу золота.
4. Як часто? Щоразу? Лише після засинання телефона? Лише на 6m? Усе, що ви можете уточнити, звужує пошук.
5. Прикріпіть лог. Вилучіть 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, один раз погодьтеся на анонімне надсилання звітів про збої, і ми побачимо трасування стека автоматично. Вам не потрібно нічого робити — але додавання «Я щойно надіслав звіт про збій з пристрою X близько <час>» до issue допомагає нам зіставити його.
• Якщо у вас є ADB, живий системний лог зазвичай містить трасування збою одразу після того, як він стається:

  adb logcat -d > logcat.txt

  Прикріпіть logcat.txt на додачу до debug.log.

9Конфіденційність

Лог налагодження — це просто текст. Він захоплює події роботи застосунку, а не ваші особисті дані. Ви побачите рядки на кшталт:

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, паролів ваших облікових записів, фотографій, контактів чи місцеположення. Ваш позивний і локатор там є, оскільки вони ідентифікують вашу станцію — але це в будь-якому разі публічна інформація для ліцензованих радіоаматорів.

Якщо хочете пробігтися чи відредагувати перед надсиланням, файл — це простий текст UTF-8. Будь-який текстовий редактор його відкриє.