Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Revision 1023948 of Nightly を使ってコントリビュートする

  • リビジョンの URL スラグ: Tools/Contributing/Contribute_on_nightly
  • リビジョンのタイトル: Nightly を使ってコントリビュートする
  • リビジョンの ID: 1023948
  • 作成日:
  • 作成者: hashedhyphen
  • 現行リビジョン? いいえ
  • コメント 実際の手順に合わせた説明に変更

このリビジョンの内容

注意:  このドキュメントではコントリビュートの新しいワークフローを説明しています。このワークフローは bug 1225108 として最近リリースされたアドオンに関連しており、このドキュメントは作成途中の段階です。

このページでは Firefox 開発ツール へコントリビュートするシンプルな方法を説明します。この方法であれば、Firefox をビルドしたり特別な環境を用意する必要はありません。

準備として必要なのは、Firefox のソースコードと Firefox Nightly をダウンロードすることだけです。ダウンロードが終わったら、ソースコードから開発ツールを起動するように Nightly を設定します。ソースコードを編集した際には、シンプルなショートカットキーを Nightly で入力するだけで、自分の書いた新しいソースコードが開発ツールに反映されます。

Firefox のソースコードをダウンロード

GitHub でミラーリングされている https://github.com/mozilla/gecko-dev をクローンします。

git clone --depth 1 https://github.com/mozilla/gecko-dev.git

--depth 1 を付けることでダウンロード時間を大幅に短縮できます(1MB/s の接続環境であれば、1 時間から 5 分に短縮されます)。こうすると、リポジトリの履歴全体を確認できなくなりますが、初めてパッチを書く際には問題とならないはずです。

Firefox Nightly のインストール

Firefox Nightly は こちら からダウンロードできます(コピー & ペーストできるリンクが必要であれば こちら も利用できます)。

Firefox に開発用のプロファイルを設定

Firefox の開発用に個別のプロファイルを用意すると、以下のようなことが可能となります。

  • 異なる Firefox のインスタンスを 2 つ同時に実行できます(1 つは通常のブラウジング用、もう 1 つはハッキング用)。
  • クラッシュの検証時に開発用のプロファイルを利用していれば、ブックマークや履歴などの重要なデータを失わずに済みます。

この設定画面を表示させるには、コマンドライン引数に "-no-remote -P" を与えて Firefox を実行するだけであり、非常に簡単です。

Windows の場合は Firefox を起動するショートカットをデスクトップに作成し、この引数が渡るようにリンクを編集します。それにはまずショートカットを右クリックし、「プロパティ」を選択し、「リンク先」の末尾に " -no-remote -P" を追加します。

詳しくは こちらのドキュメント を参照してください。

Nightly の開発ツールをソースコードから読み込む

それでは開発用のプロファイルで Nightly 起動し、タブの URL に about:debugging を入力します。続いて、

  1. Add-ons パネルが選択されていることを確認し、"Load Temporary Add-on" をクリックします。
  2. 先程クローンした git リポジトリのルートディレクトリに移動し、"devtools" フォルダをダブルクリックし、
  3. "install.rdf" ファイルを選択します。
  4. 以上です!アドオンが登録されてリストに表示されているのを確認できるはずです。
  5. 開発ツールを起動します。この時点でローカルのソースコードが読み込まれています。コードベースに 編集・検証を加え、ショートカットキー CTRL+ALT+R を叩いて開発ツールをリロードします。再度開発ツールを起動すれば、自分の加えた変更が反映されているはずです。

How to register the devtools addon living in gecko codebase, in order to load devtools from a local checkout.

Nightly とソースコードを最新版に同期

注意:  Nightly を更新した際はソースコードも更新することが重要です。Firefox を更新する毎にローカルのソースコードも更新すべきです。

ソースコードを更新する際には以下を実行します。

git fetch origin

これによりリモートの更新がローカルにダウンロードされます。

これが終わったら、以下の 2 通りの方法で自分のファイルを更新します。

  • ローカルに変更を何も加えていない場合
    git checkout origin/master
  • ローカルに加えた変更を保存したい場合
    git rebase -i origin/master
    

git の利用方法に関する詳細は git のドキュメント を参照してください。

 

コントリビュート

この素早いワークフローを利用して開発ツールにコントリビュートすることができます。 このワークフローは通常の長いプロセスと非常に似ていますが、ここまで説明したように必要な準備が短い点で異なります。通常では時間のかかる段階をスキップして、直接 バグの修正 に取り掛かることが可能になります。

このリビジョンのソースコード

<div class="warning">
<p><strong>注意:</strong>&nbsp; このドキュメントではコントリビュートの新しいワークフローを説明しています。このワークフローは <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1225108">bug 1225108</a> として最近リリースされたアドオンに関連しており、このドキュメントは作成途中の段階です。</p>
</div>

<p>このページでは <a href="/ja/docs/Tools/">Firefox 開発ツール</a> へコントリビュートするシンプルな方法を説明します。この方法であれば、Firefox をビルドしたり特別な環境を用意する必要はありません。</p>

<p>準備として必要なのは、Firefox のソースコードと Firefox Nightly をダウンロードすることだけです。ダウンロードが終わったら、ソースコードから開発ツールを起動するように Nightly を設定します。ソースコードを編集した際には、シンプルなショートカットキーを Nightly で入力するだけで、自分の書いた新しいソースコードが開発ツールに反映されます。</p>

<h2 id="Firefox_のソースコードをダウンロード">Firefox のソースコードをダウンロード</h2>

<p>GitHub でミラーリングされている <a class="external external-icon" href="https://github.com/mozilla/gecko-dev">https://github.com/mozilla/gecko-dev</a> をクローンします。</p>

<pre class="brush: bash line-numbers  language-bash">
<code class="language-bash">git clone --depth 1 </code>https://github.com/mozilla/gecko-dev.git</pre>

<p><code>--depth 1</code> を付けることでダウンロード時間を大幅に短縮できます(1MB/s の接続環境であれば、1 時間から 5 分に短縮されます)。こうすると、リポジトリの履歴全体を確認できなくなりますが、初めてパッチを書く際には問題とならないはずです。</p>

<h2 id="Firefox_Nightly_のインストール">Firefox Nightly のインストール</h2>

<p>Firefox Nightly は <a href="https://nightly.mozilla.org/">こちら</a> からダウンロードできます(コピー &amp; ペーストできるリンクが必要であれば <a href="https://ftp.mozilla.org/pub/firefox/nightly/latest-mozilla-central/">こちら</a> も利用できます)。</p>

<h2 id="Firefox_に開発用のプロファイルを設定">Firefox に開発用のプロファイルを設定</h2>

<p>Firefox の開発用に個別のプロファイルを用意すると、以下のようなことが可能となります。</p>

<ul>
 <li>異なる Firefox のインスタンスを 2 つ同時に実行できます(1 つは通常のブラウジング用、もう 1 つはハッキング用)。</li>
 <li>クラッシュの検証時に開発用のプロファイルを利用していれば、ブックマークや履歴などの重要なデータを失わずに済みます。</li>
</ul>

<p>この設定画面を表示させるには、コマンドライン引数に "<code>-no-remote -P</code>" を与えて Firefox を実行するだけであり、非常に簡単です。</p>

<p>Windows の場合は Firefox を起動するショートカットをデスクトップに作成し、この引数が渡るようにリンクを編集します。それにはまずショートカットを右クリックし、「プロパティ」を選択し、「リンク先」の末尾に "<code> -no-remote -P</code>" を追加します。</p>

<p>詳しくは <a href="https://support.mozilla.org/ja/kb/profile-manager-create-and-remove-firefox-profiles">こちらのドキュメント</a> を参照してください。</p>

<h2 id="Nightly_の開発ツールをソースコードから読み込む">Nightly の開発ツールをソースコードから読み込む</h2>

<p>それでは開発用のプロファイルで Nightly 起動し、タブの URL に <code>about:debugging</code> を入力します。続いて、</p>

<ol>
 <li>Add-ons パネルが選択されていることを確認し、<em>"Load Temporary Add-on"</em> をクリックします。</li>
 <li>先程クローンした git リポジトリのルートディレクトリに移動し、"<em>devtools</em>" フォルダをダブルクリックし、</li>
 <li>"<em>install.rdf</em>" ファイルを選択します。</li>
 <li>以上です!アドオンが登録されてリストに表示されているのを確認できるはずです。</li>
 <li>開発ツールを起動します。この時点でローカルのソースコードが読み込まれています。コードベースに <a href="https://wiki.mozilla.org/DevTools/Hacking">編集・検証を加え</a>、ショートカットキー CTRL+ALT+R を叩いて開発ツールをリロードします。再度開発ツールを起動すれば、自分の加えた変更が反映されているはずです。</li>
</ol>

<p><img alt="How to register the devtools addon living in gecko codebase, in order to load devtools from a local checkout." src="https://mdn.mozillademos.org/files/12345/about_debugging_addon.png" style="height:467px; width:1207px" /></p>

<h2 id="Nightly_とソースコードを最新版に同期">Nightly とソースコードを最新版に同期</h2>

<div class="warning">
<p><strong>注意:</strong>&nbsp; Nightly を更新した際はソースコードも更新することが重要です。Firefox を更新する毎にローカルのソースコードも更新すべきです。</p>
</div>

<p>ソースコードを更新する際には以下を実行します。</p>

<pre class="brush: bash line-numbers  language-bash">
<code class="language-bash">git fetch origin</code></pre>

<p>これによりリモートの更新がローカルにダウンロードされます。</p>

<p>これが終わったら、以下の 2 通りの方法で自分のファイルを更新します。</p>

<ul>
 <li>ローカルに変更を何も加えていない場合
  <pre class="brush: bash line-numbers  language-bash">
<code class="language-bash">git checkout origin/master</code></pre>
 </li>
 <li>ローカルに加えた変更を保存したい場合
  <pre class="brush: bash line-numbers  language-bash">
<code class="language-bash">git rebase -i origin/master</code>
</pre>
 </li>
</ul>

<p>git の利用方法に関する詳細は <a href="https://git-scm.com/book/ja/v2">git のドキュメント</a> を参照してください。</p>

<p>&nbsp;</p>

<h2 id="コントリビュート">コントリビュート</h2>

<p>この素早いワークフローを利用して開発ツールにコントリビュートすることができます。 このワークフローは通常の長いプロセスと非常に似ていますが、ここまで説明したように必要な準備が短い点で異なります。通常では時間のかかる段階をスキップして、直接 <a href="/ja/docs/Tools/Contributing#Fixing_a_bug">バグの修正</a> に取り掛かることが可能になります。</p>
このリビジョンへ戻す