Подготовка баг-репортов

На этой странице содержится информация, которая поможет вам сообщить об ошибках в Ubuntu Touch. Тут НЕ содержится информации как сообщить об ошибках в приложениях. Об том можно узнать на страничке приложения в OpenStore.

Установите последнюю версию Ubuntu Touch

Шаг очевидный, но его легко пропустить. Перейдите в меню Настройки - Обновления и убедитесь, что для вашего устройства нет доступных обновлений Ubuntu. Если их нет, действуйте по этой инструкции. Если доступны обновления, установите их и попробуйте воспроизвести ошибку. Если ошибка все еще проявляется, воспользуйтесь советами из этой инструкции. Если баг не проявляется, то, скорее всего, он был исправлен в последнем обновлении.

Проверьте, сообщалось ли об этой ошибке раньше

Зайдите на официальный баг-трекер ubuntu-touch.

Примечание

Владельцы смартфонов Pinephone могут сообщать об ошибках здесь <https://gitlab.com/ubports/community-ports/pinephone> _

Сначала нужно проверить, что об этой ошибке ранее не сообщалась. Посмотрите существующие баг-репорты. При поиске используйте ключевые слова, максимально описывающие ошибку. Например, «Блокировка экрана не скрывает рабочую область» или «Блокировка экрана показывает активные приложения».

Если Вы обнаружите, что баг-репорт уже существует, нажмите кнопку «Add your Reaction» (выглядит как смайлик) и выберите опцию +1 (палец вверх). Это покажет, что Вы тоже столкнулись с этим багом.

Если в баг-репорте отсутствует какая-либо информация, которая есть в этой инструкции, добавьте ее самостоятельно, чтобы помочь разработчикам исправить ошибку.

Воспроизведение найденной ошибки

Далее выясните точно, как можно воспроизвести найденный баг. Детально документируйте все действия, которые ведут к проявлению ошибки. Затем перезагрузите телефон и выполните эти шаги снова. Если проблема все равно проявляется, перейдите к следующему шагу. Если нет … <https://youtu.be/nn2FB1P_Mn8?t=10s> _

Составление баг-репорта

Теперь наконец-то можно составить баг-репорт! Сообщения об ошибках отправляются только на английском языке.

Первый шаг - зайдите на баг-трекер и нажмите на клавишу «New Issue» («Новая заявка»). Перед этим нужно войти в свою учётную запись на GitHub.

Шаг второй. Придумайте название багу. Название не должно быть длинным, в нескольких словах (4-8 слов) нужно передать всю суть ошибки.

Теперь напишите баг-репорт. В хорошем сообщении об ошибке содержится следующее:

  • Что случилось: краткое описание проявления ошибки

  • Что должно быть: как должна себя вести программа, если бы ошибки не было

  • Как воспроизвести баг: список действий, которые нужно совершить, чтобы ошибка проявилась.

  • Версия операционной системы: перейдите в меню «Настройки» - «О программе» и напишите то, что указано в строке «OS». Также укажите канал для релизов, использующийся для установки ОС на телефон.

Как только заполните сообщение об ошибке, опубликуйте его на трекере. Обычный пользователь не может добавлять ярлыки, поэтому укажите в описании устройство, на котором возникла проблема, чтобы модератор указал правильные теги позже.

Разработчик или работник отдела качества (QA) ознакомится с сообщением и подтвердит ошибку. После этого баг-репорт поступит в работу. Если не будет хватать какой-либо информации, разработчики напишут дополнение к сообщению, поэтому обязательно проверяйте его статус на трекере!

Получение лог-файлов

Сейчас мы рассмотрим основные шаги для получения лог-файлов Ubuntu Touch. В этих файлах может содержаться важная информация для процессов отладки. Разработчики могут попросить приложить эти файлы к баг-репорту. В этом разделе написано как получить лог-файлы с устройства.

Предупреждение

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

Для начала скачайте приложение Logviewer <https://open-store.io/app/logviewer.neothethird> из OpenStore. Эта программа специально предназначена для просмотра, подготовки и отправки лог-файлов.

Теперь откройте приложение Logviewer. Вы увидите список всех лог-файлов, доступных в папке пользователя, ``/home/phablet/.cache/upstart / ``. Тут находится большинство лог-файлов от приложений, работающих на мобильном устройстве. Можно выбрать любой журнал и просмотреть его. В правом верхнем углу есть клавиша «Отправить», с помощью неё можно отправить эти файлы разработчикам.

Если лог-файл для Logviewer отсутствует, возможно, он находится в другой папке или приложение еще его не создало. Сообщите об этом разработчику, которые этот файл запрашивает.