MDN wants to talk to developers like you: https://qsurvey.mozilla.com/s3/a3e7b5301fea

この記事ではFirefox OSプロジェクト(GaiaとB2Gを含む)のバグを登録するためのガイドを提供します。

Bugzilla

Mozillaでは、ほとんどのプロジェクトでバグおよび課題の状況のトラッキングのためにBugzillaを使っています。バグを見つけた時は誰でもbugzillaに登録できます。Bugzillaの中に、Firefox OS 向けに独立したプロダクトカテゴリがあって、GaiaGonk、Geckoなどのトピック用のコンポーネントを含んでいます。Firefox OS、Gaia、その他のバグはこのコンポーネントに登録してください。

バグを登録する

効果的にバグを登録するために、Bugzilla templateを使い、下記の手順にしたがってテンプレートを埋めてください。

必須のフィールドと任意のフィールド

新しいバグを登録する時、下記を含むいくつかのフィールドは必須項目です。

フィールド 内容
Component バグの所属するカテゴリを選択します。もし、バグがどのカテゴリに所属するかわからない時には、"General"(一般)を選択してください。
Summary バグの内容を簡潔に記述します。
Description

できるだけ明確に状況を記述します。良いバグレポートをするには、再現手順(STR)、あるべき結果と実際の結果を含めてください。また、可能であれば発生頻度 (つまり、何度も再現手順を繰り返した場合、バグが何度発生するか) を含めてください。

Build Information

Firefox OS端末の画面で、「環境設定 > 端末情報 > その他の情報」の順に操作し、下記の項目をバグレポートに含めてください。​

  • OS のバージョン
  • ビルドナンバー
  • プラットフォームのバージョン
  • ビルド ID
  • 更新チャンネル
  • Git コミット情報

もし、MacやLinuxなどで adb や git をインストールして使っているのであれば、このスクリプトを実行して、その結果をテキストでコピー&ペーストしてください。

Screenshots バグを解析するのに役立つスクリーンショットを添付します。(Flameでは、電源ボタンと音量下げボタンを2秒以上同時に押し続けると、音や画面のフラッシュがしてスクリーンショットが撮れます。それをUSBを経由してコンピュータに転送してください。)
Video バグが画面遷移をする中で発生し、スクリーンショットで説明するのが難しい場合は、動画を撮影してください。その動画を添付ファイルとしてアップロードできます。また、YouTubeにアップロードしてそのURLをバグレポートにコピー&ペーストすることもできます。
ADB logs コンピューターに adb がインストールされている場合、電話機に接続しておいて | adb logcat | を実行して表示される結果をプレーンテキストに保存し、バグレポートに添付してください。

下記のフィールドは任意です:

フィールド 内容
Depends/Block バグ同士の依存関係を表します。
Keywords bugzilla用のキーワードです。特定のグループがバグをトラッキングするのに使われます。
Whiteboard タグを含みます。トラッキング用にあらゆるタグを追加して下さい。他人のタグを許可なく削除してはいけません。
See Also 異なるバグが関連している際に、このフィールドで指定できます。
Flags ステータストラッキング用のフラグです。Firefox OSでは、 blocking-b2g というフラグが最もよく使われます。バグが blocking-b2g にセットされた場合、そのバグはリリースをブロックするため、そのバグにより注意を払う必要があります。
Security バグが個人情報のセキュリティや、資産の損失や、そのような問題に関連している場合、このチェックボックスをチェックしてください。このチェックによって、そのバグは専任の従業員のみが見ることができるようになります。

bugzillaのフィールドの詳細な説明については、Bugzilla内にあるBugzilla Fieldsページを参照してください。

ローカライゼーションのバグを登録する

翻訳されていない文字列がある場合、以下の2通りの可能性があります。

  • 翻訳者がまだ文字列を翻訳していない場合。この場合はバグを登録しないでください。
  • ローカライザビリティ(localizability - l12y)の問題で翻訳者が文字列を翻訳できなかった場合。この場合はバグを登録してください。

ローカライザビリティ(l12y)バグを登録するには

  1. Firefox OSで「環境設定 > 端末情報 > その他の情報」を開き、「開発者メニュー」をオンにしてください。
  2. 「環境設定 > 開発者」で「Pseudo-Localization」をオンにしてください。
  3. 「環境設定 > 言語」で「Accented English」(奇妙な文字列で表示されています)を選択してください。
  4. 文字列が翻訳されていなかった画面に戻ります。もし、文字列が通常の英語で表示されていれば(Accented Englishの奇妙な文字列で表示されていなければ)、多くの場合それは l12y の問題です。
  5. Bugzillaで、 product に「Firefox OS」を指定し、さらに翻訳されていない文字列があるコンポーネントを指定してください。キーワードには「l12y」を指定してください。
  6. 必須事項を記入し、バグを登録してください。

よくあるキーワード

Firefox OS のバグでよく使われるキーワードを下記の表に示します。

バグを検証したり、バグにコメントをしたり、バグの StatusVerified に設定するときには、必ず ビルド/OS/プラットフォーム を明示する必要があります。もし、バグが3つのプラットフォームで報告されて、あなたが確認や修正したのがそのうち1つである場合、それをバグのノートに明示し、バグを Verified に変更しないでください。 Status が Verified に変更されるときには、全てのプラットフォームでチェックが行われる必要があります。

最終的に、その他のバグがあなたの検証しているバグの複製であるとマークされた場合、それらにチェック、言及する事を確実にしてください。しばしば開発者は関連した(だが同一でない)バグを複製としてマークし、これらがチェックされていないと見過ごされる事があります。

キーワード 内容
meta バグがステータストラッキングバグであることを示します。Mozillaは複数のバグや、ユーザーストーリーの実装状況を追跡するのにこのタグを使います。一旦このマークがなされると、開発者はこうしたバグの上部にパッチを置くべきではありません。プロジェクトマネージャーやQAスタッフが追跡のためにmetaバグを使うのを覚えておいて下さい。
qablocker テスト (手動や自動の機能テスト)をブロックするバグにこのキーワードを使用します。このバグは、次の Beta や RC のマイルストーンまでには修正する必要があります。
qawanted もっと情報が必要な時や、再現法やテストケースが必要であったり、複製だったり (だが複製元のオリジナルバグが見つからない)する時に、このキーワードを使います。必要なQA作業の進捗はホワイトボードに記録されます;つまり必要なQA作業が完了した 時は、このキーワードを削除すべきです。
regression

このキーワードは、問題が修正され、また戻ってきて(退行して)いて、新規バグとは疑わしいという意味であり、退行を追跡するために記録します。またpre-check inテストやスモークテストでは特定できず、以前のビルドで動作していたが現在のビルドで見つかった問題を参照することもあります。こうしたバグの追跡は、ぜい弱な場所や、故障の傾向や、スモークテストやpre-check inテストの追加の良い候補の見極めに役立ちます。

regressionwindow-wanted バグがregression(退行)であり、バグがどの期間に、理想的にはどのチェックインで起きたのかが特定できると大変有益であることを示します。
steps-wanted 再現手順を特定すると大変有益なバグを強調します。
verifyme このバグはQA連絡先が指示した以外の人が、最新のB2Gビルドで検証するのがokという意味です。このバグは、修正を検証するのに詳しく指定された特定マシンの設定があります。失敗の再現を試みて、Fixed の解決法が正しいと思う場合に、ステータスを Verified とマークすべきです。
crash FX OSがクラッシュするときにこのキーワードを追加してください。

: 追加の資料として、 Bug writing guideline を参照してください。Mozillaの B2G QA Wiki ページ(英語)もFirefox OSのバグを扱うのに役立ちます。中でも、 Bugzilla Usage (英語)や Incoming bug triage for Firefox OS (英語)は特に役立ちます。

: Gaia開発中のバグの扱いについての詳細情報は、Gaiaのパッチを提出するを読んで下さい。

ドキュメントのタグと貢献者

 このページの貢献者: chrisdavidmills, hamasaki, Uemmra3, nayuta, dskmori, saneyuki_s, mkato
 最終更新者: chrisdavidmills,