MDN may have intermittent access issues April 18 13:00 - April 19 01:00 UTC. See whistlepig.mozilla.org for all notifications.

mozilla

Revision 50902 of Building and installing Firefox OS

  • Revision slug: Mozilla/Boot_to_Gecko/Building_and_installing_Boot_to_Gecko
  • Revision title: Building and installing Boot to Gecko
  • Revision id: 50902
  • Created:
  • Creator: Sheppy
  • Is current revision? No
  • Comment add TOC for subpages; 236 words added

Revision Content

Because Boot to Gecko is currently under active development, and is in a prerelease state, the best way to ensure you have an up-to-date copy installed is to build and install it yourself. The articles listed on this page will guide you through building and installing B2G on an emulator or compatible device, or the Gaia user interface in the Firefox browser.

Getting and building Boot to Gecko

B2G build prerequisites
What you'll need (and need to do) before you build Boot to Gecko for the first time.
Getting the B2G code
How to find and download the latest Boot to Gecko code for the first time.
Building Boot to Gecko
How to build Boot to Gecko.

View All...

Installing Boot to Gecko and/or Gaia

Choosing how to run Gaia or B2G
You can use Gaia within Firefox, or you can run B2G on a mobile device or in a desktop-based simulator. This guide will help you decide which is best for your needs.
Using Gaia in Firefox
How to use Gaia within a desktop Firefox browser.
Using the B2G simulator
A guide to running and using the Boot to Gecko simulator.
Installing Boot to Gecko on a mobile device
How to install B2G on a real mobile device.

Running Gaia using Firefox Nightly

If you have some knowledge of git, you can clone the Gaia repository and launch Gaia using a recent Firefox Nightly build.

Pros: 
  • no build system  and very little setup required
  • can use the Firefox dev tools
Cons:
  • the viewport is based on the size of the browser window
  • many device-like things won't work
  • apps are launched in separate, pinned tabs
  • Firefox Nightly might be unstable

Building and Running B2G desktop builds

It is possible to build a Boot to Gecko 'simulator' and run Gaia using this application. This software is based on Firefox but behaves similar to the on-device experience of Boot to Gecko. Currently Mozilla is working on providing nightly builds of this application for developers, and this work is being tracked in bug 744008. If you are familiar with building the Firefox code-base or C++ projects, you can build this application yourself following these instructions.

Pros: 
  • mobile viewport, similar experience to a mobile device in most respects
  • more device apis ( not all )
Cons:
  • need to install a C/C++ build system and build Gecko
  • The Firefox dev tools are not available.

Setting up & building Boot to Gecko

Revision Source

<p>Because Boot to Gecko is currently under active development, and is in a prerelease state, the best way to ensure you have an up-to-date copy installed is to build and install it yourself. The articles listed on this page will guide you through building and installing B2G on an emulator or compatible device, or the <a href="/en/Mozilla/Boot_to_Gecko/Introduction_to_Gaia" title="en/Mozilla/Boot_to_Gecko/Introduction_to_Gaia">Gaia</a> user interface in the Firefox browser.</p>
<nobr>
<table class="topicpage-table"> <tbody> <tr> <td> <h3 name="Documentation">Getting and building Boot to Gecko</h3> <dl> <dt><a href="/en/Mozilla/Boot_to_Gecko/B2G_build_prerequisites" title="en/Mozilla/Boot_to_Gecko/B2G build prerequisites">B2G build prerequisites</a></dt> <dd>What you'll need (and need to do) before you build Boot to Gecko for the first time.</dd> <dt><a href="/en/Mozilla/Boot_to_Gecko/Getting_the_B2G_code" title="en/Mozilla/Boot_to_Gecko/Getting the B2G code">Getting the B2G code</a></dt> <dd>How to find and download the latest Boot to Gecko code for the first time.</dd> <dt><a href="/en/Mozilla/Boot_to_Gecko/Building_Boot_to_Gecko" title="en/Mozilla/Boot_to_Gecko/Building Boot to Gecko">Building Boot to Gecko</a></dt> <dd>How to build Boot to Gecko.</dd> </dl> <p><span class="alllinks"><a href="/Special:Tags?tag=B2G&amp;language=en" title="Special:Tags?tag=B2G&amp;language=en">View All...</a></span></p> </td> <td> <h3 name="Community">Installing Boot to Gecko and/or Gaia</h3> <dl> <dt><a href="/en/Mozilla/Boot_to_Gecko/Choosing_how_to_run_Gaia_or_B2G" title="en/Mozilla/Boot_to_Gecko/Choosing how to run Gaia or B2G">Choosing how to run Gaia or B2G</a></dt> <dd>You can use Gaia within Firefox, or you can run B2G on a mobile device or in a desktop-based simulator. This guide will help you decide which is best for your needs.</dd> <dt><a href="/en/Mozilla/Boot_to_Gecko/Using_Gaia_in_Firefox" title="en/Mozilla/Boot_to_Gecko/Using Gaia in Firefox">Using Gaia in Firefox</a></dt> <dd>How to use Gaia within a desktop Firefox browser.</dd> <dt><a href="/en/Mozilla/Boot_to_Gecko/Using_the_B2G_simulator" title="en/Mozilla/Boot_to_Gecko/Using the B2G simulator">Using the B2G simulator</a></dt> <dd>A guide to running and using the Boot to Gecko simulator.</dd> <dt><a href="/en/Mozilla/Boot_to_Gecko/Installing_Boot_to_Gecko_on_a_mobile_device" title="en/Mozilla/Boot_to_Gecko/Installing Boot to Gecko on a mobile device">Installing Boot to Gecko on a mobile device</a></dt> <dd>How to install B2G on a real mobile device.</dd> </dl> </td> </tr> </tbody>
</table>
<h4>Running Gaia using Firefox Nightly</h4>
<p>If you have some knowledge of git, you can clone <a class="link-https" href="https://github.com/mozilla-b2g/gaia" title="https://github.com/mozilla-b2g/gaia">the Gaia repository</a> and launch Gaia using a recent Firefox Nightly build.</p>
<div class="ace-line" id="magicdomid231"><span class="author-g-f6nw4vuclfx20dyp">Pros: </span></div>
<div class="ace-line" id="magicdomid254"> <ul class="list-bullet1"> <li><span class="author-g-f6nw4vuclfx20dyp">no build system  and very little setup required</span></li> <li><span class="author-g-f6nw4vuclfx20dyp">can use the Firefox dev tools</span></li> </ul>
</div>
<div class="ace-line" id="magicdomid297"><span class="author-g-f6nw4vuclfx20dyp">Cons:</span></div>
<div class="ace-line" id="magicdomid334"> <ul class="list-bullet1"> <li><span class="author-g-f6nw4vuclfx20dyp">the viewport is based on the size of the browser window</span></li> <li><span class="author-g-f6nw4vuclfx20dyp">many device-like things won't work</span></li> <li><span class="author-g-f6nw4vuclfx20dyp">apps are launched in separate, pinned tabs</span></li> <li><span class="author-g-f6nw4vuclfx20dyp">Firefox Nightly might be unstable</span></li> </ul> <h4>Building and Running B2G desktop builds</h4> <p>It is possible to build a Boot to Gecko 'simulator' and run Gaia using this application. This software is based on Firefox but behaves similar to the on-device experience of Boot to Gecko. Currently Mozilla is working on providing nightly builds of this application for developers, and this work is being tracked in <a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=744008" title="https://bugzilla.mozilla.org/show_bug.cgi?id=744008">bug 744008</a>. If you are familiar with building the Firefox code-base or C++ projects, you can build this application yourself <a class="link-https" href="https://wiki.mozilla.org/Gaia/Hacking#Building_B2G" title="https://wiki.mozilla.org/Gaia/Hacking#Building_B2G">following these instructions</a>.</p> <div class="ace-line" id="magicdomid471"><span class="author-g-f6nw4vuclfx20dyp">Pros: </span> <ul class="list-bullet1"> <li><span class="author-g-f6nw4vuclfx20dyp">mobile viewport, similar experience</span> to a mobile device in most respects</li> <li><span class="author-g-f6nw4vuclfx20dyp">more device apis ( not all )</span></li> </ul> </div> <div class="ace-line" id="magicdomid548"><span class="author-g-f6nw4vuclfx20dyp">Cons:</span></div> <div class="ace-line" id="magicdomid613"> <ul class="list-bullet1"> <li><span class="author-g-f6nw4vuclfx20dyp">need to install a C/C++ build system and build Gecko</span></li> <li><span class="author-g-f6nw4vuclfx20dyp">The Firefox dev tools</span> are not available.</li> </ul> </div>
</div>
<h2>Setting up &amp; building Boot to Gecko</h2>
<ul> <li><a href="/en/Mozilla/Boot_to_Gecko/Setting_Up_Boot_to_Gecko_Build_Environment_for_Ubuntu" title="https://developer.mozilla.org/en/Mozilla/Boot_to_Gecko/Setting_Up_Boot_to_Gecko_Build_Environment_for_Ubuntu">Setting up B2G Build Environment for Ubuntu</a> (Reference Setup)</li> <li><a href="/en/Mozilla/Boot_to_Gecko/Setting_Up_Boot_to_Gecko_Build_Environment_for_Arch_Linux" title="https://developer.mozilla.org/en/Mozilla/Boot_to_Gecko/Setting_Up_Boot_to_Gecko_Build_Environment_for_Arch Linux">Setting up B2G Build Environment for Arch Linux</a></li> <li><a href="/en/Mozilla/Boot_to_Gecko/Setting_up_Boot_to_Gecko_Build_Environment_for_Mac_OS_X" title="en/Mozilla/Boot_to_Gecko/Setting_Up_Boot_to_Gecko_Build_Environment_for_Mac_OS_X">Setting up B2G Build Environment for Mac OS X</a></li> <li><a href="/en/Mozilla/Boot_to_Gecko/Building_B2G_for_QEMU_Emulator" title="en/Mozilla/Boot_to_Gecko/Building_B2G_for_QEMU_Emulator">Building B2G for QEMU Emulator</a></li> <li><a href="/en/Mozilla/Boot_to_Gecko/Building_B2G_for_Samsung_Galaxy_S2" title="en/Mozilla/Boot_to_Gecko/Building_B2G_for_Samsung_Galaxy_S2">Building and flashing B2G for Samsung Galaxy S2</a></li> <li><a href="/en/Mozilla/Boot_to_Gecko/Building_B2G_for_Samsung_Nexus_S" title="en/Mozilla/Boot_to_Gecko/Building_B2G_for_Samsung_Nexus_S">Building and flashing B2G for Samsung Nexus S</a></li> <li><a href="/en/Mozilla/Boot_to_Gecko/Updating_an_existing_B2G_phone" title="en/Mozilla/Boot_to_Gecko/Updating an existing B2G phone">Updating an existing B2G phone</a></li>
</ul></nobr>
Revert to this revision