remote/doc/Building.md
author Cosmin Sabou <csabou@mozilla.com>
Wed, 24 Apr 2019 19:55:51 +0300
changeset 470691 2ff0f3923d0bc5f2f8b3721a0e18fa9b6215aff0
parent 470672 57a319eeed2db0eb76136664456233de47c101df
child 471179 da2d4529a200f41df8978b0310f1f1c9d7f9cb4e
permissions -rw-r--r--
Backed out 4 changesets (bug 1533831) for xpcshell failures on remote/test/unit/test_Error.js. CLOSED TREE Backed out changeset a3014b38cc5f (bug 1533831) Backed out changeset 57a319eeed2d (bug 1533831) Backed out changeset afcfdae88bf7 (bug 1533831) Backed out changeset c03450df8660 (bug 1533831)

Building
========

The remote agent is by default not included in Firefox builds.
To build it, put this in your [mozconfig]:

	ac_add_options --enable-cdp

This exposes a `--remote-debugger` flag you can use to start the
remote agent:

	% ./mach run --setpref "browser.fission.simulate=true" -- --remote-debugger

When you make changes to the XPCOM component you need to rebuild
in order for the changes to take effect.  The most efficient way to
do this, provided you haven’t touched any compiled code (C++ or Rust):

	% ./mach build faster

Component files include the likes of RemoteAgent.js, RemoteAgent.manifest,
moz.build files, prefs/remote.js, and jar.mn.  All the JS modules
(files ending with `.jsm`) are symlinked into the build and can be
changed without rebuilding.

[mozconfig]: ../build/buildsystem/mozconfigs.html