Дайте нам лог,
и мы сможем это исправить.

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. Любой текстовый редактор его откроет.