Firefox OS 2.5+ supports add-ons, a feature already familiar to Firefox Desktop users, which allows customization of specific apps or the whole OS — behaviour more to your liking. The Firefox Marketplace acts as a host for add-ons as well as apps; this article provides an overview of how to submit your add-ons for publication.
- Navigate to Firefox Marketplace Content Tools and log in to the site.
- After you've logged in, select the Submit Firefox OS Add-on button to go to the Submit a Firefox OS Add-on page; this is where the process starts.
- Click Select a File and select the add-on zip package you want to submit. See the Add-on package structure section below for more details on the required package/manifest format.
- You can optionally add submission notes. These are only for review purposes and are not publicly available — testing instructions, test login details, etc.
- Click Submit. Your add-on will now be validated.
- If there are any errors you’ll be sent back to Step 3 to resubmit an updated zip file.
- If not, you will be redirected to your dashboard, where all your submissions will be listed.
- After a reviewer has looked at your add-on, an email will be sent to notify you of the outcome.
Editing and updating your add-on
After successful submission of your add-on, you can edit/update it by going to your dashboard and selecting Edit this add-on.
New add-on versions can be added on this page. Uploading a new version while a previous version is pending review will mark the previous version obsolete and the new version will then be marked pending review instead (a maximum of 1 version can be pending review at one time.)
Once a version is approved then that will be available for installation; it will remain available until a newer version is approved.
Add-on package structure
The add-on is submitted as a zip file. This section details what the zip must contain.
The manifest.json (Manifest file) must be in the root of the zip file. Key details are as follows:
descriptionis optional but will be used by the Marketplace on the Add-on detail page.
iconsis used to find icons to display on the marketplace, and on the device when the add-on is installed.
authorisn’t currently used by the Marketplace, but will be shown on the device when the add-on is installed.
Note: Validation describes the current state of the manifest validator.
You can review the Firefox OS add-ons review criteria to make sure your add-on follows it.