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

1Что в логе

SSTV-AF ведёт ротируемый текстовый файл под названием debug.log в каталоге данных своего приложения. Он захватывает такие вещи, как:

• События подключения / отключения USB и какое устройство CAT совпало
• Попытки автоподключения и любые сбои
• Последовательные кадры CAT, отправленные трансиверу и полученные от него
• Смены диапазона, частоты и режима SSTV
• События жизненного цикла при запуске и остановке приложения

Это простой текст, безопасный для чтения, и он не содержит паролей или ключей API загрузки. Смотрите раздел конфиденциальность ниже, если хотите пробежаться по нему перед тем, как делиться.

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

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

Удаляет текущий лог. Полезно, если хотите начать с чистого листа перед воспроизведением бага — просто нажмите Clear, выйдите из диалога, воспроизведите проблему, вернитесь и поделитесь. Более короткий лог облегчает нам нахождение значимых событий.

Logcat: ON / OFF

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

4Запасной путь: приложение Files

Если по какой-то причине вы не можете добраться до экрана Debug внутри приложения — старая сборка, разблокировка не сработала, вы просто предпочитаете файловый менеджер — файл лога также живёт на диске в папке данных приложения:

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

1. Откройте приложение Files (или Мои файлы) на телефоне.
2. Перейдите в Внутренняя память → Android → data. На некоторых устройствах Android скрывает эту папку по умолчанию; коснитесь меню из трёх точек и включите Показать скрытые файлы или Системные папки.
3. Откройте папку пакета SSTV-AF, затем files. Внутри вы должны увидеть debug.log.
4. Удерживайте debug.log и коснитесь Поделиться.

5Запасной путь: ADB

Для разработчиков с компьютером и инструментом adb Android:

1. На телефоне включите Параметры разработчика → Отладка по USB.
2. Подключите телефон к компьютеру по USB, примите запрос авторизации отладки.
3. Из терминала убедитесь, что телефон виден:

   adb devices -l

4. Извлеките лог из папки данных приложения:

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

   На установках с несколькими устройствами укажите телефон явно через -s <serial>.

6Напишите issue

Полезный отчёт об ошибке невелик — трёх-четырёх коротких абзацев достаточно. Шаблон, который всегда работает:

1. Что вы сделали? «Настроился на 14.230, станция начала передавать Scottie 1.» Конкретные действия по порядку. Не нужно описывать приложение — только то, чего вы коснулись.
2. Чего вы ожидали? «Я ожидал, что картинка прорисуется чисто.»
3. Что произошло на самом деле? «Изображение пришло наклонённым, а цвета были сдвинуты влево.» Если что-то появилось на экране — всплывающая ошибка, зависший интерфейс, странный водопад — опишите это. Скриншот — на вес золота.
4. Как часто? Каждый раз? Только на одном режиме? Только после засыпания телефона? Всё, что вы можете уточнить, сужает поиск.
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

- 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 хранит отдельный отчёт о сбое. Два места, куда смотреть:

• Если вы на сборке с отчётами о сбоях, один раз согласитесь на анонимную отправку отчётов, и мы увидим трассировку стека автоматически. Добавление «Я только что отправил отчёт о сбое с устройства 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.230 MHz

Чего там нет: ключей API Cloudlog или Wavelog, паролей ваших аккаунтов, фотографий, контактов или местоположения. Ваш позывной и локатор там есть, поскольку они идентифицируют вашу станцию — но это в любом случае публичная информация для лицензированных радиолюбителей.

Если хотите пробежаться или отредактировать перед отправкой, файл — это простой текст UTF-8. Любой текстовый редактор его откроет.