今やデスクトップでGaiaを実行していて、コードベースがどう動作するかをある程度理解し、プロジェクトにコントリビュート(貢献)し始める準備ができているでしょう。この記事では変更を加える方法と、取り組むべきバグの見つけ方を記述します。
Gitのベストプラクティス
- Gaiaに変更を加える時は、まず最新をmasterから取得すべきです:
cd path/to/gaia git checkout master git pull upstream master
- 次に、あなたの修正を乗せるブランチをチェックアウトします:
git checkout -b my-code-fix
- 最後に、
gaia/appsディレクトリに移動し、アプリファイルを変更します。
簡単なコード変更例
コード変更を見るには:
- Gaiaコードベースに必要な変更を加え、変更を保存します。
- FirefoxのMuletか、WebIDE内のsimulatorをシャットダウンします。
makeを使ってGaiaプロフィールをリビルドします。- FirefoxのMuletか、WebIDE内のsimulatorを再起動します。
ロックスクリーンの時計の色変更のような簡単な例を見てみましょう:
- スタイルがどうやってセットされているのか見つける最良の方法は、開発者ツールを使うことです。デスクトップ版Firefoxで Ctrl/右 + クリックしてコンテキストメニューから 要素を調査 を選びます。
- どのCSSファイルを編集するかがわかったら — ここでは
gaia/apps/system/lockscreen/style/lockscreen.css— 画面右手側で、CSSファイルが望み通りの状態になるよう編集します。 - 変更に満足したら、ファイルディレクトリに移動して変更します。
- 次に、この節の最初で概説したステップに従い、変更を見ます。
Gaia Firefox Muletのレンダリング制限:
- デスクトップ版Firefoxレンダリングでは、アプリは実機の動作と比べてはるかに正確ですが、あちこちに違いがあるかもしれません。
- デスクトップ版Firefoxでは全てのデバイスAPIをサポートしているわけではありません;有効なデバイスAPI一覧は preferences.js に見ることができます。
取り組むべきバグを見つける場所
Firefox OS のバグを見つける最良の方法は、 Josh Matthews の、Bugs Ahoy(おーいバグ)、アプリです — これはMozilla の Bugzilla からバグを直接引き込んで、検索、閲覧しやすく表示してくれます。 いったん取り組むバグを見つけたら、Bugzilla ページに移動して"assigned to" 項目に自分自身を入力し、下記に示すように、作業を開始します。
有用なヒント
- 助言つき(mentored)バグに取り組む時、Gaiaコアチームの誰かがあなたの進捗をモニタし、コードとプロセスとの援助を提供します。あなたがFirefox OSの貢献プロセスの初心者である場合、 これらに参加するのは有用です。これらはFirefox OS Bugzilla ページの"Mentors"項目に入力されていることで示されます。 Bugs Ahoy で助言つきバグが一覧できます。
- あなたが完全に新しいBugzillaユーザーである場合、自身をバグの担当にアサインできないかもしれません。できない場合、権限のある助言者にアサインしてもらうよう依頼するか、もしくは単にバグコメントで依頼して下さい。
- 多少経験を積んだ後、自身にバグのアサインできる権限を誰かに依頼するべきでしょう。
- 新しいコントリビューターが簡単なバグを探す場合、もう一つ探すのに良いホワイトボードエントリーは
[good first bug]です。最初のバグに適したリストは https://www.joshmatthews.net/bugsahoy/?b2g=1&simple=1 で一覧できます。 - 貢献したいプロジェクトを探すのには検索結果を保存すべきです。例えば下記では Gaia Clock アプリのバグ検索が取得できます:
参考情報
- Gaia powerpoints for visual/interaction specifications
- Weekly Gaia meeting Etherpad
- Datazilla: Mozilla's performance test utility