Add-ons/developer/communication/nov2016 update
Evolution in Add-on Development
WebExtensions are becoming the standard for add-on development in Firefox. It is expected to become the only type of add-on supported in Firefox by the end of 2017.
This page contains timelines, tutorials, and other resources to help you port your add-on to WebExtensions. If you're looking for resources on creating a new add-on, please head over to MDN.
What's New
- WebExtension Experiments: prototype WebExtension APIs without having to build Firefox
- Embedded WebExtensions: we're making it easier to port to WebExtensions in Firefox 51
- Help plan and prioritize WebExtensions APIs by joining the bi-weekly public triage
- Porting guides that map SDK and XUL APIs to available WebExtensions APIs
- How-to guides covering common add-on developer cases, like intercepting web requests and adding a button to the toolbar
Timelines & Roadmap
- See a graph of upcoming multiprocess Firefox (e10s) changes, organized by Firefox release dates.
- Public Trello boards:
- Add-on planning: see what the add-ons team is working on
- Impacting changes: see what changes are coming up that impact compatibility
- WebExtensions Roadmap: see which APIs are coming up
Migration paths for developers affected by the changes
1) Has SDK add-on using low level APIs
Developers who created an SDK add-on using low-level APIs, which break with multiprocess Firefox (aka Electrolysis or e10s).
Migration Path
If your add-on code accesses web content using a low-level SDK APIs like window/utils or tabs/utils, then you will likely be affected.
Multiprocess Firefox is currently going through a phased roll-out through early 2017, so we urge you to test your add-ons for compatibility.
- If it breaks in multiprocess Firefox, your users will be impacted, and you will need to update your add-on. You can find documentation on how to make them compatible here.
- If it does not break in multiprocess Firefox, you should add the
multiprocess
permission in package.json.
For assistance, please join the dev-addons@mozilla.org mailing list and ask for help!
2) Has SDK add-on using legacy APIs
Developers who created an SDK add-on, but uses either XPCOM or other legacy APIs.
Migration Path
Developers in this group potentially have to update their add-on twice--once for e10s compatibility (if using low-level APIs), and again for WebExtensions compatibility (because it uses legacy APIs).
- Use only high-level APIs - High-level APIs are e10s compatible and are more likely to have an equivalent WebExtensions API. You will have to migrate again once WebExtensions are fully ready, but it should be pretty easy to do in this case.
- Move to WebExtensions - Check the SDK/WebExtensions comparison chart to see if the APIs you need are available, and see what else we're doing to mitigate the impact of this transition.
3) Has SDK add-on using only high level APIs
Developers who used the SDK for their add-ons using only high-level APIs. Might have played around with the Chrome extension API in the past.
Migration Path
We recommend you start looking into WebExtensions, which by the end of 2017 will be the only type of add-on supported. Check the SDK/WebExtensions comparison chart to see if the APIs you need are available, and see what else we're doing to mitigate the impact of this transition.
4) Has XUL or XPCOM add-on
Developers who created add-ons that don't rely on the SDK or WebExtensions.
Migration Path
The transition to WebExtensions impacts add-ons built on APIs like XUL and XPCOM most of all. We expect to remove support for these technologies in Firefox add-ons by the end of 2017. We hope this will give us enough time to help you migrate and provide WebExtension APIs that are suitable for replacing the features you might lose once we stop supporting these APIs.
If you’ve already updated your add-on for multiprocess Firefox (e10s) compatibility, thank you for clearing this hurdle. If not, find out how.
To get started migrating to WebExtensions, check the XUL/XPCOM-WebExtensions comparison chart to see if the APIs you need are available. Additional resources can be found below.
For assistance, please join the dev-addons@mozilla.org mailing list and ask for help!
Managing the Impact
- Embedded WebExtensions - In Firefox 51, you can embed a WebExtensions add-on inside an existing SDK or bootstrapped add-on. This is especially useful to developers of SDK or bootstrapped add-ons who want to start migrating to WebExtensions and take advantage of new APIs like Native Messaging, but can’t fully migrate yet. It’s also useful for developers who want to complete data migration towards WebExtensions, and who want to take parts of their add-on that are not compatible with multiprocess Firefox and make them compatible.
- WebExtension Experiments - now it's easier to prototype WebExtension APIs, and you can do it without having to build Firefox.
- We're always adding new WebExtensions documentation, so please check them out!
- Not all add-ons will be able to migrate to WebExtensions without having to drop any features. But we want to work with you to get as many add-ons migrated as possible with the functionality you created intact. We invite you to contribute to its evolution, and we look forward to working with you.
Add-on Developer Communication Calendar
This calendar includes public meetings, scheduled blog posts, office hours, release milestones that affect add-on developers, and more. Links to add it to your own calendar: iCal | HTML
Blog Posts and Other Resources
WebExtensions
Blog Posts
- Sep 29, 2016: WebExtensions in Firefox 51
- Sep 13, 2016: WebExtensions and parity with Chrome
- Aug 25, 2016: WebExtensions in Firefox 50
- Aug 12, 2016: WebExtensions Taking Root
- July 27, 2016: Linting and Automatically Reloading WebExtensions
- July 21, 2016: New WebExtensions Guides and How-tos on MDN
- July 14, 2016: WebExtensions support on AMO
- June 9, 2016: WebExtensions in Firefox 49
- May 9, 2016: Results of the WebExtensions API Survey
- Apr 29, 2016: WebExtensions in Firefox 48
- Apr 14, 2016: Developing Extensions With Web-ext 1.0
- Mar 30, 2016: Tinkering with WebExtensions
- Mar 14, 2016: Advantages of WebExtensions for Developers
- Mar 11, 2016: WebExtensions in Firefox 47
- Feb 2, 2016: WebExtensions in Firefox 46
- Jan 9, 2016: WebExtensions First Impressions
- Dec 21, 2015: WebExtensions in Firefox 45
- Aug 21, 2015: The Future of Developing Firefox Add-ons
Other Resources
- Compatibility Lookup Tool
- Embedded WebExtensions let you embed a WebExtensions add-on inside an existing SDK or bootstrapped add-on
- Comparison with the Add-on SDK
- Comparison with XUL/XPCOM extensions
- How-to guides covering common add-on developer cases, like intercepting web requests and adding a button to the toolbar
- Browser compatibility table for all WebExtensions APIs
- Example add-ons created with WebExtensions APIs
Multiprocess (e10s) Firefox
Blog Posts
- Sep 7, 2016: Help make add-ons multiprocess compatible with Add-on Compatibility Reporter
- Aug 2, 2016: Multi-process Firefox and Add-ons: A Call to Action for Extension Developers
- June 17, 2016: Multi-process Firefox and AMO
- Apr 11, 2016: The “Why” of Electrolysis
- Nov 23, 2015: Test your add-ons for Multi-process Firefox compatibility
Other Resources
Migrating from XUL/XPCOM
Blog Posts
- Sep 28, 2016: How Video DownloadHelper Became Compatible with Multiprocess Firefox
- Apr 26, 2016: Migrating Popup ALT Attribute from XUL/XPCOM to WebExtensions
Other Resources
Get in Touch
- IRC:
- #teamaddons: team chat
- #addons: support for extensions, themes, plugins and addons.mozilla.org
- #amo: addons.mozilla.org bugs and development
- #amo-editors: add-on reviews and policy
- #extdev: extension development
- #themedev: theme development
- #webextensions: web extensions
- Mailing List: dev-addons
- Blog: https://blog.mozilla.org/addons/
- Forum: https://discourse.mozilla-community.org/c/add-ons