Skip to main content

Installs Marionette as an extension on an FxOS device

Project description

marionette-extension

This repository contains Marionette in gecko extension form, intended for use with FxOS devices. It includes an installation script which you can use, provided your phone is connected via ADB:

source install_marionette_extension.sh VERSION

Where VERSION is a supported version number, one of: 1.3, 1.4, 2.0, 2.1, 2.2, or 2.5.

If you need to install adb, see https://developer.mozilla.org/en-US/Firefox_OS/Debugging/Installing_ADB

FirefoxOS v1.3 through v2.5 are currently supported.

Python Package

This is also the ‘marionette_extension’ python package. Once you install this package, you will have access to a command line program called install_marionette which you can use like so:

marionette_extension --help

Which will show you what installation options you have available to you.

If you need an example, this is how you can install Marionette on a v1.3 device:

marionette_extension --install 1.3

You can also import the marionette_extension package into your python script and use its install function to install marionette via a script. Example:

from marionette_extension import install
install(FXOS_VERSION, adb=ADBPATH) # Replace FXOS_VERSION with a supported version, and you may use ADBPATH to specify your adb path. If not specified, it will assume 'adb' is on the $PATH

How to add a new version?

  1. Create a new folder indicating your new gecko version

  2. hg clone https://hg.mozilla.org/mozilla-central/

Starting now, please reference on the files and folder structure of previous marionette-extension version

  1. Go to mozilla-central folder and find /testing/specialpowers(mozilla-central) and copy them into special-powers@mozilla.org folder

  2. Copy all the .js files in /testing/marionette(mozilla-central) to marionette@mozilla.org/chrome/content

  3. Copy chrome.manifest and install.rdf from previous version of marionette-extension to marionette@mozilla.org folder

  4. Copy testing/marionette/components/marionettecomponent.js(mozilla-central) to /marionette@mozilla.org/components and rename it to marionetteextensioncomponent.js

  5. Do this to marionetteextensioncomponent.js:

    1. replace MARIONETTE_CONTRACTID value with “@mozilla.org/marionetteextension;1”

    2. change the profile-after-change listener to always start Marionette and not be dependent on build flags or command lines

    this.enabled = true;
    this.logger.info("marionette enabled via extension");
    // We want to suppress the modal dialog that's shown
    // when starting up in safe-mode to enable testing.
    if (Services.appinfo.inSafeMode) {
    this.observerService.addObserver(this, "domwindowopened", false);
    }
    1. change the component name from MarionetteComponent to MarionetteExtensionComponent

  6. request of putting this on pypi for faster installation

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

marionette_extension-0.4.9.tar.gz (693.9 kB view details)

Uploaded Source

File details

Details for the file marionette_extension-0.4.9.tar.gz.

File metadata

File hashes

Hashes for marionette_extension-0.4.9.tar.gz
Algorithm Hash digest
SHA256 2d111b91f22f336fa96d0f324790c6a82759858376d31b69874f83a67904e107
MD5 4b57fa5fbf32c2029d856a9b1fb6b111
BLAKE2b-256 0a2ca1b65453ba93c2298e23491e3e764c1bf92055ffbd3848a105bb9e9f9e94

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page