Skip to content

Instantly share code, notes, and snippets.

@wbamberg
Created June 25, 2012 22:40
Show Gist options
  • Save wbamberg/2991904 to your computer and use it in GitHub Desktop.
Save wbamberg/2991904 to your computer and use it in GitHub Desktop.

Mobile add-ons

Expected final state

  • New starters can understand the whole process of add-on development on fennec
  • Desktop firefox add-on developers understand what's different in fennec
  • All add-on developers understand:
    • The tool support available for developing fennec add-ons
    • The power of specifically mobile add-ons
    • How to use the fennec-specific add-on APIs
    • How to localize fennec add-ons
  • The reference material for fennec-specific add-on APIs is correct and complete

Relevant Actions

New starters can understand the whole process of add-on development on fennec

  • Write a walkthrough of creating a Fennec Native extension
    • start to finish, including building the XPI and pushing it to a device, using whatever tools we have for that (i.e. if we have something that wraps adb)
    • creating a real add-on with some visible UI and behaviour, so people can follow along and have something that does something, that they can tinker with
    • standalone:
      • not assuming any previous knowledge
      • not explaining stuff by pointing people at the generic add-on documentation

Desktop firefox add-on developers understand what's different in fennec

  • Write a walkthrough of porting from a desktop (XUL-based, non-restartless) add-on to Fennec Native

All add-on developers understand the tool support available for developing fennec add-ons

  • Write a guide to:
    • setting up ADB to communicate with a real Android device
    • setting up Fennec Native on the Android emulator

All add-on developers understand the power of specifically mobile add-ons

  • Write a series of tutorials showing how to use mobile-oriented APIs - camera, geolocation, telephony - to do interesting things with an add-on. Structure them around developing a simple but interesting add-on.

All add-on developers understand how to use the fennec-specific add-on APIs

  • Write a guide on "Building a UI": introducing the use of NativeWindow to build a UI, with examples and screenshots

  • Write a guide on "Interacting with the Browser": introducing the use of BrowserApp to work with tabs &c, with examples

  • Write a guide on "Initialization and Cleanup": presenting the template for "bootstrap.js", explaining where and how to create persistent UI and make any the changes, and where, how, and what to clean up (this is closer to restartless-generic than fennec-specific).

All add-on developers understand how to localize fennec add-ons

  • Write a localization guide for Fennec add-ons

The reference material for fennec-specific add-on APIs is correct and complete

  • NativeWindow structured API reference

  • BrowserApp structured API reference

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment