Compare Revisions

How to set up the Firefox OS Simulator on your desktop computer.

Here's how to get Firefox OS running on your desktop computer. These instructions are based on those by Staś Małolepszy. For more info, see [http://informationisart.com/11/ his blog post]. {for linux} {note}'''Note:''' These instructions are for Windows or Mac. :({/note} {/for} __TOC__ {for mac} =Using the Firefox OS Simulator add-on for Firefox= The [https://addons.mozilla.org/en-US/firefox/addon/firefox-os-simulator/ Firefox OS Simulator] add-on (formerly [https://hacks.mozilla.org/2012/10/r2d2b2g-an-experimental-prototype-firefox-os-test-environment/ r2d2b2g]) for Firefox is now available. It works very well on Mac and Windows and can get you running Firefox OS in under a minute. For more information, you can read about [https://developer.mozilla.org/en-US/docs/Mozilla/Boot_to_Gecko/Using_Firefox_OS_simulator Using Firefox OS Simulator]. If the Firefox OS Simulator add-on doesn't work for some reason, complete the following steps. =Prepare your computer= ''If you don't have these things already installed, you'll need to do this before you can get Firefox OS running.'' #[http://itunes.apple.com/us/app/xcode/id497799835?mt=12 Install XCode from the Mac App store.] #Once it's "installed" from the App store, open the app to finish the installation. #Then, open the XCode preferences and install the Command Line Tools. #:[[Image:Command line tools]] #Finally, download and install Git from http://git-scm.com/downloads =Get the Boot2Gecko app= #Download the latest nightly build from [http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central/ ftp.mozilla.org]. You want the latest '''mac64.dmg''' file. #Double-click the .dmg file you just downloaded to open it and then drag the '''B2G.app''' to your {filepath Applications} folder. =Get Gaia= #First, create a folder to hold everything. For these instructions, we'll create a "FirefoxOS" folder in your {filepath Documents} folder. #Open up the Terminal application. You automatically start in your {filepath Home} folder (username:~). #:[[Image:Terminal home]] #In the Terminal window, switch to the FirefoxOS folder you created in step 1 by typing, '''cd Documents/FirefoxOS''' and then hit {button return}. #:[[Image:Terminal FirefoxOS]] #Next, clone the Gaia repository (in English that means, download a copy to your computer) by typing, '''git clone https://github<!-- -->.com/mozilla-b2g/gaia gaia''' and then hit {button return}. #:{note}'''Tip:''' You can copy and paste commands from this article into your Terminal.{/note} #*A bunch of stuff will happen and you'll see a download progress. When everything is done and you have a prompt again (username:FirefoxOS username$), continue with the next step. #Now you need to create a profile by typing, '''DEBUG=1 make -C gaia profile''' and then hit {button return}. #*Again, a bunch of stuff will happen. When you have a prompt again you'll be done. =Start Firefox OS= *To start Firefox OS, open the Terminal and type, '''/Applications/B2G.app/Contents/MacOS/b2g -profile ~/Documents/FirefoxOS/gaia/profile''' and hit {button return}. {note}'''Note:''' Use the {button home} or {button fn}+{button left arrow} buttons on your keyboard to simulate the home button on the device.{/note} =Update= This desktop version doesn't auto-update. To update it manually: #Download and install the latest nightly build from [http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-central/ ftp.mozilla.org]. #Open the Terminal, navigate to the {filepath gaia} folder inside the {filepath FirefoxOS} folder by typing, '''cd ~/Documents/FirefoxOS/gaia''' #Then type, '''git pull''' {/for} {for win} =Get the Boot2Gecko app= #Download the [http://www.microsoft.com/en-us/download/details.aspx?id=8328 Microsoft Visual C++ 2010 SP1 Redistributable Package (x86)]. #Start the installer and follow the instructions. #Download the [https://github.com/downloads/sihorton/b2g-desktop-profile-installer/b2g-gaia-desktop.exe pre-built installer for b2g-desktop with pre-compiled gaia]. #Start the installer and follow the instructions. Be sure to leave the two checkboxes checked. =Start Firefox OS= Simply click the {menu b2g-gaia-desktop} application shortcut from the Windows Start menu to launch Firefox OS. {note}'''Note:''' Use the {button home} button on your keyboard to simulate the home button on the device.{/note} =Auto update= This pre-built installer includes an automatic update feature. The second time you launch the app, it will check for updates and ask you if you want to upgrade. Simply click {button Yes} and follow the instructions. The installer will detect your previous install and ask to remove it before upgrading -- say {button Yes} to that too. {/for}