Подготовка баг-репортов#
На этой странице содержится информация, которая поможет вам сообщить об ошибках в Ubuntu Touch. Тут НЕ содержится информации как сообщить об ошибках в приложениях. Об том можно узнать на страничке приложения в OpenStore.
Установите последнюю версию Ubuntu Touch#
Шаг очевидный, но его легко пропустить. Перейдите в меню Настройки - Обновления и убедитесь, что для вашего устройства нет доступных обновлений Ubuntu. Если их нет, действуйте по этой инструкции. Если доступны обновления, установите их и попробуйте воспроизвести ошибку. Если ошибка все еще проявляется, воспользуйтесь советами из этой инструкции. Если баг не проявляется, то, скорее всего, он был исправлен в последнем обновлении.
Проверьте, сообщалось ли об этой ошибке раньше#
Open up the bug tracker for ubuntu-touch.
Примечание
Владельцы смартфонов Pinephone могут сообщать об ошибках здесь <https://gitlab.com/ubports/community-ports/pinephone> _
Сначала нужно проверить, что об этой ошибке ранее не сообщалась. Посмотрите существующие баг-репорты. При поиске используйте ключевые слова, максимально описывающие ошибку. Например, «Блокировка экрана не скрывает рабочую область» или «Блокировка экрана показывает активные приложения».
Если Вы обнаружите, что баг-репорт уже существует, нажмите кнопку «Add your Reaction» (выглядит как смайлик) и выберите опцию +1 (палец вверх). Это покажет, что Вы тоже столкнулись с этим багом.
Если в баг-репорте отсутствует какая-либо информация, которая есть в этой инструкции, добавьте ее самостоятельно, чтобы помочь разработчикам исправить ошибку.
Воспроизведение найденной ошибки#
Далее выясните точно, как можно воспроизвести найденный баг. Детально документируйте все действия, которые ведут к проявлению ошибки. Затем перезагрузите телефон и выполните эти шаги снова. Если проблема все равно проявляется, перейдите к следующему шагу. Если нет … <https://youtu.be/nn2FB1P_Mn8?t=10s> _
Составление баг-репорта#
Теперь наконец-то можно составить баг-репорт! Сообщения об ошибках отправляются только на английском языке.
First, pull up the bug tracker and click «New Issue». Log in to GitHub if you haven’t yet.
Шаг второй. Придумайте название багу. Название не должно быть длинным, в нескольких словах (4-8 слов) нужно передать всю суть ошибки.
Теперь напишите баг-репорт. В хорошем сообщении об ошибке содержится следующее:
Что случилось: краткое описание проявления ошибки
Что должно быть: как должна себя вести программа, если бы ошибки не было
Шаги к воспроизведению: Вы записали это раньше, верно?
Версия операционной системы: перейдите в меню «Настройки» - «О программе» и напишите то, что указано в строке «OS». Также укажите канал для релизов, использующийся для установки ОС на телефон.
Как только заполните сообщение об ошибке, опубликуйте его на трекере. Обычный пользователь не может добавлять ярлыки, поэтому укажите в описании устройство, на котором возникла проблема, чтобы модератор указал правильные теги позже.
Разработчик или работник отдела качества (QA) ознакомится с сообщением и подтвердит ошибку. После этого баг-репорт поступит в работу. Если не будет хватать какой-либо информации, разработчики напишут дополнение к сообщению, поэтому обязательно проверяйте его статус на трекере!
Получение лог-файлов#
Сейчас мы рассмотрим основные шаги для получения лог-файлов Ubuntu Touch. В этих файлах может содержаться важная информация для процессов отладки. Разработчики могут попросить приложить эти файлы к баг-репорту. В этом разделе написано как получить лог-файлы с устройства.
Предупреждение
В лог-файлах может содержаться конфиденциальная информация. Пожалуйста, просматривайте эти файлы перед отправкой разработчикам или размещением в публичном доступе. С разработчиками можно договориться о передаче таких файлов через электронную почту или какие-то менее публичные сервисы.
To get ready, download the Logviewer app from the OpenStore. This app will help us find, view, and send the logs we need.
Now, open the Logviewer app. You’ll see the list of applications running on your device. You can open any of them to view the logs of this application. And you can use the «send» icon in the top right corner to share a log using an online service.
Если лог-файл для Logviewer отсутствует, возможно, он находится в другой папке или приложение еще его не создало. Сообщите об этом разработчику, которые этот файл запрашивает.