Эта статья содержит руководство по оформлению ошибок в Firefox OS, включая Gaia и B2G.
Bugzilla
Как и в большинстве проектов Mozilla, мы используем Bugzilla для отслеживанию ошибок и проблем. Вы можете опубликовать ошибку в bugzilla, при её обнаружении можете использовать отдельный продукт для Firefox OS, который содержит компоненты, включающие Gaia, Gonk и Gecko. Вы должны использовать его, чтобы подать ошибку в Firefox OS, Gaia, и др.
Отправка ошибок
Чтобы подать правильно обнаруженную ошибку используйте Bugzilla шаблон и следуйте инструкциям ниже, чтобы заполнить шабло
Обязательные и не обязательные поля
При подаче новой ошибки эти поля являются обязательными для заполнения:
| Field | Описание |
|---|---|
| Component | Выберите категорию ошибки к которой он принадлежит. Если Вы не понимаете, в какую категорию его нужно занести, Вы можете выбрать "Общие". |
| Summary | Кратко опишите найденную ошибку. |
| Description | Опишите ситуацию ясно. Ошибка должна содержать действия по воспроизведению (STR), ожидаемые результаты и фактические результаты. Просим также указать частоту воспроизведения (то есть, сколько раз ошибка появляется, если вы повторите шаги снова и снова). |
| Build Information | Перейдите в раздел "Настройки"> "Информация об устройстве"> "Дополнительная информация" и выберите следующее: OS Version, Build Number, Platform Version, Build Identifier, Update Channel and Git Commit Info. (Если у вас есть компьютер Mac / Linux с установленными АБР и Git, вы можете запустить этот скрипт и вставить отчет в ошибку.) |
| Screenshots | Пожалуйста, приложите скриншот, который может помочь нам понять ошибку. (На Flame устройстве, нажмите и удерживайте кнопку питания и нижнюю качельку громкости в течение 2 секунд пока на телефоне не появится уведомление о скриншоте. Затем перенесите скриншот в компьютер через USB.) |
| Video | Если Вашу ошибку трудно отобразить с помощью скриншота,то пожалуйста снимите её на видео. Вы можете загрузить видео как файл в качестве приложения к ошибке. Вы также можете загрузить видео на YouTube и вставить ссылку на него. |
| ADB logs | Если у Вас на компьютере установлен ADB, то подключите к компьютеру телефон и выполните команду | ADB LogCat |. Пожалуйста, вставте отчет этой команды в текстовый файл и приложите его к ошибке. |
Следующие поля являются необязательными:
| Field | Описание |
|---|---|
| Depends/Block | Описать зависимость между ошибками. |
| Keywords | Ключевые слова для Bugzilla. Они будут использованы для отслеживания. |
| Whiteboard | Ключевые теги. Добавьте любой тег к ошибке для отслеживания. Вы не должны удалять другие теги без разрешения. |
| See Also | Иногда, две ошибки связаны между собой и вы можете указать это здесь. |
| Flags | Флаги для отслеживания статуса ошибки; наиболее часто используемый флаг в Firefox OS "blocking-b2g". Если ошибка устанавливается с флагом "blocking-b2g" это означает, что мы должны обращать больше внимания на эту ошибку, так как она угрожает заблокировать выпуск обновления. |
| Security | Если ошибка связана с безопасностью персональных данных, денежными средствами и другими подобными вопросами, вы должны указать это, и ошибка будет видна только специальной категории сотрудников. |
Чтобы найти более подробную информацию о bugzilla fields, Вы можете открыть Bugzilla Fields страницу на Bugzilla.
Отправка ошибок локализации
Когда Вы видите не переведенную строку, это может означать две вещи:
- Переводчик не перевел эту строку. Не сообщайте об ошибке в этом случае!
- Переводчик не мог перевести строку из-за локальной (l12y) ошибки. Пожалуйста, сообщите об ошибке в этом случае.
Как подать локальные (l12y) ошибки
- In Firefox OS, go to Settings > Device Information > More Information and toggle on the Developer Menu.
- Go to Settings > Developer and turn on Pseudo-localization.
- Go to Settings > Language and scroll to the bottom to select accented English.
- Go back and look at the untranslated string. If it appears in normal English and not accented English, it is most probably because of a localizability (l12y) issue.
- In Bugzilla, file a bug under the product 'Firefox OS'. Select the component under which the untranslated string appears. Add 'l12y' in the Keyword field.
- Please fill out all the other mandatory fields.
Common keywords
The following table provide information on common keywords you'll see used in Firefox OS bugs.
You should always indicate the build/OS/platform(s) used to verify the bug in the bug comments, before you change the Status to Verified. If the bug is reported on all three platforms and you only have one platform to verify the fix on, go ahead and do so and note it in the bug, but do not mark the bug as Verified. All platforms must be checked before moving Status to Verified.
Finally, if other bugs have been marked as a duplicate of the bug you're verifying, be sure to check and mention those as well. Often developers mark related — but not identical — bugs as duplicates, and these can be overlooked if not checked.
| Keyword | Description |
|---|---|
| meta | Indicates that the bug is a status tracking bug. Mozilla uses this tag to tracking multiple bug or user story implementation statuses. Once marked like this, developers should not land patches on top of such bugs. Please be reminded that project managers and QA staff will use meta bugs for tracking. |
| qablocker | Use this keyword for bugs that are blocking testing (manual or automated testing of a feature) and need to be fixed by the next Beta or RC milestone. |
| qawanted | Use this keyword for bugs that need more info, require reproducing or testcasing, or are duplicates (but you can't find the original bug being duplicated). Required QA work progress is recorded in the whiteboard; you should remove this keyword when the required QA work has been completed. |
| regression | This keyword means that the problem was fixed, but then it came back (regressed) and the bug in question is a new bug, filed to track the regression. It can also refer to problems outside those identified in pre-check in and smoke tests, which were found in current builds and that were known to be working in previous builds. Tracking these bugs helps us to identify areas that are fragile, prone to breakage and are good candidates for adding to smoke and pre-check in tests. |
| regressionwindow-wanted | Indicates that the bug is a regression, and would strongly benefit from someone identifying the time period in which it happened, ideally to a specific check in. |
| steps-wanted | Highlights a bug that would greatly benefit from someone identifying the steps to reproduce it. |
| verifyme | Means that this bug is ok to verify with the latest FX OS build by someone other than the QA Contact indicated. The bug has specific machine configuration details indicated for verifying the fix. You should try to reproduce the failure, and, if you agree that the resolution of Fixed is correct, mark the Status as Verified. |
| crash | Add this keyword if you encounter a crash in FX OS. |
Note: You can additionally refer to Bug writing guidelines. The Mozilla B2G QA Wiki page also has some useful resources on handling Firefox OS bugs; the most useful pages are Bugzilla Usage and Incoming bug triage for Firefox OS.
Note: For more information on handling bugs during Gaia development, read Submitting a Gaia patch.