cordova-firefoxos allows developers to use the cross platform APIs in Cordova to target the Firefox OS. Most APIs are just proxied to the matching Firefox OS API calls.
A lot of good documentation is available on the Mozilla Developer Network
A simulator (runs as a Firefox plugin) is availble here
The following software is required to package and deploy an app directly to a Firefox OS device:
-on Mac you will need to install XCode & Command Line Tools for XCode
-Firefox OS device with OS Version 188.8.131.52 prerelease
- Bootstrap your computer so to make sure that you have all the prerequisites for building Firefox
- instructions can be found under the "Build prerequisites" section on the following page
- Clone the Firefox repository: git clone git://github.com/mozilla/mozilla-central.git
- Build Firefox by following the instructions under the "Building" on the following page
- Clone the cordova-firefoxos repository
If Deploying to device:
- Modify the XPCSHELL constant in the Makefile to point to the location of xpcshell on your computer
- Modify the ADB constant in the Makefile to point to the location of adb on your computer
- Make sure the Firefox OS device has remote debugging enabled. To enable remote debugging navigate to the following settings on the device: Settings->Device Information->More Information->Developer->Remote Debugging.
- Run the Makefile by typing "make" into the command line.
- The device should prompt you to allow a remote connection, your Apache Cordova Firefox OS app will be installed to the device once you accept the prompt.
If Deploying to simulator:
- Open the Firefox OS simulator add-on by going to Tools->Web Developer->Firefox OS Simulator
- Start the simulator
- Click on the Add Directory button and then choose the manifest.webapp file in the framework folder of your Apache Cordova app.