Building GCLI For Firefox

  • Revision slug: Tools/GCLI/Building_GCLI_For_Firefox
  • Revision title: Building GCLI For Firefox
  • Revision id: 302089
  • Created:
  • Creator: jwalker
  • Is current revision? No
  • Comment

Revision Content

Getting Started

You must have a checkout of Firefox that you can build and run. For more details see the simple build instructions, or the more detailed instructions.

You will also need an installation of NodeJS, and Git. GCLI can run under Node, and it also uses Node to build its output for Firefox.

Getting GCLI

GCLI is stored in git. There are 2 repositories of note. Most of the up to date development happens in joewalker's repo, when changes have landed in mozilla-central, then they also appear in the mozilla fork.

The GCLI build step alters your checkout of mozilla-central, so it needs the FIREFOX_HOME environment variable to point at the right directory.

$ cd <WHEREVER-YOUR-FIREFOX-IS-STORED>
$ set FIREFOX_HOME=`pwd`

Getting and running GCLI looks like this:

$ git clone git://github.com/joewalker/gcli.git
$ cd gcli
$ node gcli.js
Serving GCLI to http://localhost:9999/
This is also a limited GCLI prompt. Type 'help' for a list of commands, CTRL+C twice to exit:
»

The easiest way to build GCLI into an installation of firefox is like this:

$ node gcli.js firefox

This assumes that you have setup the $FIREFOX_HOME environment variable as specified earlier. Alternatively you can do this:

$ node gcli.js firefox /path/to/mozilla-central

Now you can make changes to the GCLI source, test it in a web browser, and export a gcli.jsm package to run in Firefox

Revision Source

<h2>Getting Started</h2>
<p>You must have a checkout of Firefox that you can build and run. For more details see the <a href="/en-US/docs/Simple_Firefox_build" title="/en-US/docs/Simple_Firefox_build">simple build instructions</a>, or the <a href="/en-US/docs/Developer_Guide/Build_Instructions" title="/en-US/docs/Developer_Guide/Build_Instructions">more detailed instructions</a>.</p>
<p>You will also need an installation of <a href="http://nodejs.org" title="http://nodejs.org">NodeJS</a>, and <a href="http://git-scm.com/" title="http://git-scm.com/">Git</a>. GCLI can run under Node, and it also uses Node to build its output for Firefox.</p>
<h2>Getting GCLI</h2>
<p>GCLI is stored in git. There are 2 repositories of note. Most of the up to date development happens in <a href="https://github.com/joewalker/gcli" title="https://github.com/joewalker/gcli">joewalker's repo</a>, when changes have landed in mozilla-central, then they also appear in the <a href="https://github.com/mozilla/gcli" title="https://github.com/mozilla/gcli">mozilla fork</a>.</p>
<p>The GCLI build step alters your checkout of mozilla-central, so it needs the FIREFOX_HOME environment variable to point at the right directory.</p>
<pre>
$ cd &lt;WHEREVER-YOUR-FIREFOX-IS-STORED&gt;
$ set FIREFOX_HOME=`pwd`
</pre>
<p>Getting and running GCLI looks like this:</p>
<pre>
$ git clone git://github.com/joewalker/gcli.git
$ cd gcli
$ node gcli.js
Serving GCLI to http://localhost:9999/
This is also a limited GCLI prompt. Type 'help' for a list of commands, CTRL+C twice to exit:
»
</pre>
<p>The easiest way to build GCLI into an installation of firefox is like this:</p>
<pre>
$ node gcli.js firefox</pre>
<p>This assumes that you have setup the $FIREFOX_HOME environment variable as specified earlier. Alternatively you can do this:</p>
<pre>
$ node gcli.js firefox /path/to/mozilla-central</pre>
<p>Now you can make changes to the GCLI source, test it in a web browser, and export a gcli.jsm package to run in Firefox</p>
Revert to this revision