🌐 Русский — Community translation View in English

Отладочные журналы

Когда что-то работает неправильно, отладочные журналы приложения — это самое полезное, что вы можете приложить к отчёту об ошибке. Meshtastic может захватить их за вас, прямо из приложения — вам больше не нужен adb или какие-либо инструменты на компьютере для их сбора.

Откройте Панель отладки через Настройки → Дополнительно → Панель отладки.

📎 Создаёте задачу? Экспортируйте свои журналы (см. ниже) и прикрепите файл .txt к отчёту на [github.com/meshtastic/Meshtastic-Android/issues]. Захват журнала, охватывающий момент возникновения проблемы, превращает «это не работает» в то, что разработчик действительно может отследить.

Две вкладки

Панель отладки содержит две вкладки:

  • Пакеты — декодированный трафик mesh-сети, который ваше радио отправило и получило (сообщения уровня протокола). Полезно для диагностики поведения mesh-сети и маршрутизации.
  • Журналы приложения — собственный диагностический журнал приложения (Android logcat), включая предупреждения, ошибки и трассировки стека самого приложения. Обычно именно это требуется для отчёта об ошибке.

Каждая вкладка имеет собственную кнопку экспорта и создаёт отдельный файл, поэтому вы можете сохранить тот, который нужен — или сразу оба.

Просмотр журналов приложения

Вкладка Журналы приложения показывает самые последние строки журнала только из этого приложения — но не из других приложений на вашем устройстве.

  • Поиск — введите текст в поле поиска, чтобы отфильтровать строки по совпадению.
  • Фильтр по уровню — кнопки V / D / I / W / E переключают отображение строк с уровнями Verbose (Подробный), Debug (Отладка), Info (Информация), Warn (Предупреждение) и Error (Ошибка). Нажмите на уровень, чтобы скрыть его; нажмите ещё раз, чтобы вернуть обратно. Строки с фатальными ошибками отображаются всегда.
  • Обновить — значок обновления заново считывает последние записи журнала.

Строки с ошибками и предупреждениями подсвечиваются цветом, чтобы проблемы выделялись.

Экспорт

Нажмите на значок загрузки, чтобы сохранить текущие журналы в файл. Вы выбираете расположение через системное окно выбора файлов, а файл получает имя с меткой времени (например, meshtastic_logcat_20260701_143312.txt), поэтому повторные экспорты никогда не перезаписывают друг друга.

Прикрепите этот файл к своей задаче на GitHub.

🔒 Приватность: Экспорты автоматически удаляют приватные ключи, ключи администратора и сеансовые ключи доступа перед записью в файл. Ключи каналов (PSKs) не удаляются, а журналы также могут содержать имена узлов, координаты и другие идентифицирующие данные — бегло просмотрите файл перед публикацией и, если сомневаетесь, делитесь им конфиденциально.

Desktop

У компьютерного приложения нет системного logcat, поэтому вкладка Журналы приложения вместо этого показывает собственный захваченный вывод журнала приложения. Поиск, фильтрация и экспорт работают точно так же.

Связанные темы