gecko-dev/remote/README
Andreas Tolfsen b3dc3fc611 bug 1533831: remote: include remote agent in default build; r=firefox-build-system-reviewers,chmanchester
The previous commit disabled the remote agent by flipping the
remote.enabled preference to false.  That prevented the remote
agent from initialising or being included in the --help message.

This patch implies --enable-cdp in the default Firefox build on Firefox
Nightly.  Firefox for Android is not supported.  This will cause
builds to include the remote agent component that lives under remote/.

Since the remote agent is disabled by default, users will first
have to set the remote.enabled preference to true in order to use it.

If you wish to explicitly opt out of including the remote agent
when building Firefox, you may do so by using the --disable-cdp
build flag in your mozconfig:

	ac_add_options --disable-cdp

Differential Revision: https://phabricator.services.mozilla.com/D27540

--HG--
extra : moz-landing-system : lando
2019-04-24 17:18:22 +00:00

19 lines
687 B
Plaintext

The Firefox remote agent is a low-level debugging interface based
on the CDP protocol.
With it, you can inspect the state and control execution of documents
running in web content, instrument Gecko in interesting ways,
simulate user interaction for automation purposes, and debug
JavaScript execution.
This component provides an experimental and partial implementation
of a remote devtools interface using the CDP protocol and transport
layer.
See https://firefox-source-docs.mozilla.org/remote/ for documentation.
The remote agent is disabled by default, but can be enabled by
setting a preference before running it:
% ./mach run --setpref "remote.enabled=true" --remote-debugger