FirefoxOS Emulator

QEMU ARM as in Android Emulator + generated firmware

B2G Desktop

FirefoxOS Simulator (Custom Gecko build + fake/mocked WebAPIs)

Run Gaia on Nighly

and use Firefox-included Web Developer Tools

Marionette

for automated testing and remote interactive development

Remote Debugger

included in FirefoxOS, B2G Desktop, Firefox Android and Desktop Nightly

Mozilla MXR

Mozilla Cross-Reference sources

Connect to Gonk (ADB)

adb shell
# ps 
            

Do you want Busybox?

download/build an arm binary busybox

# and uploads it to the emulator
adb shell mount -o remount,rw /system
adb push busybox /system/bin/
adb shell chmod 0755 /system/bin/busybox
            

Connect to Gecko

Setting Up Marionette for B2G • Marionette for Interactive Python

$ adb forward tcp:2828 tcp:2828
$ python
>>> from marionette import Marionette
>>> marionette = Marionette('localhost', 2828)
>>> marionette.start_session()
u'session-b2g'
            

Get a Nightly or Build yourself

B2G-Desktop Nightly Build • Build Yourself • Build Prerequisites

Install MozREPL Extension

Let's install a powerfull introspection javascript shell into B2G
MozREPL GIT Repo

$ cd b2g
$ mkdir extensions
$ cd extensions
$ git clone https://github.com/bard/mozrepl mozrepl@hyperstruct.net

# bump toolkit compatibility in install.rdf (max to 19.*)
            

Run B2G with MozREPL enabled

Let's start b2g desktop on an existent gaia profile with MozREPL enabled

$ ./b2g -profile PATH_TO_GAIA_PROFILE -repl
$ rlwrap telnet 127.0.0.1 4242
...
Current working context: chrome://browser/content/shell.xul
Current input mode: syntax

repl> 
            

WebAPI

• Mozilla WebAPI Project Page
• WebAPI Permissions Matrix

Hack on WebAPIs from inside

### RUN ACTIVITIES (as in "Android Intents")
activity1 = new MozActivity({name: "dial", data: 
  {number: "+39328", type: "webtelephony/number"}});

activity2 = new MozActivity({name: "new", data: 
  {number: "+39328", type: "websms/sms"}});
            

Hack on WebAPIs from inside

### INSPECT OBJECTS
repl.inspect(activity1);
...

### BACK TO HOME (workaround B2G Desktop bug)
document.getElementById("homescreen").reload();
            

Hack on WebAPIs from inside

repl> repl.inspect(navigator);
object.battery
object.geolocation
object.getDeviceStorage
object.registerContentHandler
object.registerProtocolHandler
repl> 
            

Hack on WebAPIs from inside

repl> repl.search(/^moz/,navigator);
mozSettings
mozApps
mozPower
mozNotification
mozIsLocallyAvailable
mozSms
mozConnection
mozCameras
mozSetMessageHandler
mozHasPendingMessage
mozTime
            

Hack on WebAPIs from inside

repl> repl.inspect(navigator.battery);
...
repl> res = navigator.mozApps.mgmt.getAll();
repl> repl.inspect(res.result[0])
...
            

Build

Let's build Gaia profile from sources
Gaia Hacking - Build Notes

$ git clone git://github.com/mozilla-b2g/gaia.git gaia
...
$ cd gaia
$ make DEBUG=1 # to build a profile runnable on Firefox Nightly
...
            

$ make         # to build a profile runnable on B2G Desktop
...
$ make USE_LOCAL_XULRUNNER_SDK=1 # to use a local installed xulrunner sdk
...
Profile Ready: please run [b2g|firefox] -profile /tmp/gaia/profile
            

Run on Firefox Nightly

and use Responsive Design View

/path/to/firefox -profile ./profile -no-remote \
   http://clock.gaiamobile.org:8080
            

Gaia Building Blocks

App Manifest 1/2

{
  "name": "Chrono",
  "description": "Gaia Chronometer Example App",
  "launch_path": "/index.html",
  "developer": {
    "name": "Luca Greco <luca.greco@alcacoop.it>",
    "url": "https://github.com/rpl/gaia-chrono"
  },
  "installs_allowed_from": ["*"],
  ...
            

App Manifest 2/2

  "locales": {
    "en-US": {
      "name": "Chrono",
      "description": "Gaia Chronometer Example App"
    },
    ...
  },
  "default_locale": "en-US",
  "icons": {
    "120": "/icons/chrono-120.png",
    "60": "/icons/chrono-60.png"
  },
  "orientation": "portrait-primary"
}
            

Cache Manifest and Works Offline 1/2

CACHE MANIFEST
# ...
CACHE:
index.html
icons/chrono-60.png
...
            

Cache Manifest and Works Offline 2/2

# catch-all for anything else
NETWORK:
*
http://*
https://*