Developer Tools
Get the sources
git clone [email protected]:ochameau/ff-dt.git --single-branch
cd ff-dt/
Please use --single-branch
to only download master
branch.
These repo contains many branches that are not necessary to build DevTools.
Run tools with a development profile
From ff-dt
folder:
./run
* At any time, press `Ctrl+Alt+R` to reload the tools
This will create a development profile for you, with the devtools add-on pre-installed, and some preferences to ease debugging the tools. It also downloads a firefox package, and run it against the custom profile.
If you want to run against a custom Firefox, hand over an absolute path to it
via FIREFOX_BIN
environement variable.
Run tools via about:debugging
- Launch Firefox
- Open about:debugging in a new tab
- Click on "Load temporary Add-on"
- Select
ff-dt
folder and theninstall.rdf
file - Press
Ctrl+Alt+R
to load the tools - You can then press this same key shortcut at any time to reload the tools from sources
Build and test the add-on
$ ./bin/build-xpi.sh
* Launch Firefox Nightly/Dev-Edition/Aurora/Beta (i.e. all but release)
* Ensure setting `xpinstall.signatures.required` to false in `about:config`
* Drag'n drop `devtools.xpi` file in Firefox -or- execute path/to/firefox-bin ./devtools.xpi
Run tests
In order to run test you need some python deps to be installed:
- virtualenv (sudo pip install virtualenv)
- pip (sudo easy_install pip)
- npm (only for lint checks)
From ff-dt
folder:
# Setup python environement for mochitest test runner
$ source config.sh
# Run all tests
$ ./test
# Run one folder
$ ./test client/inspector/
# Run one test
$ ./test client/inspector/test/browser_inspector_highlighter-01.js
# Run xpcshell test
$ ./bin/run-xpcshell.sh server/tests/unit/test_add_actors.js
# Run lint checks, for everything
$ ./lint
# Run lint checks, for a given file or folder
$ ./lint client/inspector/
$ ./lint client/inspector/inspector.js
A lot more information is available about the tooling, CI, scripts, tooling, repos, branches
in bin/README.md
file.