- Platform Support
- The Command-Line Interface
- Platform Guides
- Using Plugman to Manage Plugins
- The config.xml File
- Icons and Splash Screens
- Embedding WebViews
- Plugin Development Guide
- Plugin Specification
- Privacy Guide
- Security Guide
- Platforms and Plugins Version Management
- Whitelist Guide
- Hooks Guide
- Next Steps
- Plugin APIs
Firefox OS Platform Guide
This guide describes how to set up your development environment to create Cordova apps for Firefox OS devices, then test and publish those apps.
Requirements and Support
Firefox OS apps are basically just web apps, with the addition of a manifest.webapp file that defines metadata about the app and allows it to be installed on Firefox OS devices. Any platform that Cordova supports can be used.To find out more about building web apps, consult the App Center on MDN.
Installation and Environment Setup
First install Node.js, then install the Cordova package like so:
$ npm install -g cordova
Next, create a sample Cordova app then navigate into the newly created directory:
$ cordova create test-app $ cd test-app
Add Firefox OS as a supported platform to the app with the following:
$ cordova platform add firefoxos
This creates a Firefox OS app in platforms/firefoxos/www directory, which currently looks the same except that it has a Firefox manifest file (manifest.webapp) inside the www directory.
Developing your app
At this point you are ready to go — change the code inside test-app/www to whatever you want your app to be. You can add supported plugins to the app using "cordova plugin add", for example:
cordova plugin add cordova-plugin-device cordova plugin add cordova-plugin-vibration
When your app code is written, deploy your changes to the Firefox OS app you've added to your project with
$ cordova prepare firefoxos
To create a packaged app one can zip the platforms/firefoxos/www directory. You can also simply build it using
$ cordova build firefoxos
The Firefox OS packaged app will be built in platforms/firefoxos/build/package.zip
Testing and Debugging
The app can be tested using the Firefox OS Web IDE.
When you have connected the Web IDE to your test device/simulator, select the "Open Packaged App" option, then make sure you point to the test-app/platforms/firefoxos/www/ directory to include the App in the Manager interface.
For here you can install the app on your test device/simulator (with the "Play" button). Using the "Pause" button you can then debug the app and edit its code live.
Note: Before attempting to publish your app you should consider validating it using the App validator.
Publishing your app on the Firefox Marketplace
You can submit your app to the Firefox Marketplace, or publish it yourself. Visit the Firefox Marketplace Zone on MDN to find out more about how to do this; App publishing options is the best place to start.