Magic-Mirror/gecko-dev
1
0
Fork 0
mirror of https://github.com/mozilla/gecko-dev.git synced 2025-01-05 15:59:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
b43ac32ce9
gecko-dev/remote/doc/Building.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

50 lines
1.5 KiB
Markdown
Raw Normal View History

bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 15:18:42 +00:00
Building
========
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
The remote agent is included in the default Firefox build, but
disabled by default. To expose the remote agent you can set the
`remote.enabled` preference to true before running it:
bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 15:18:42 +00:00
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
% ./mach run --setpref="remote.enabled=true" --remote-debugger
bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 15:18:42 +00:00
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
The source code is found under `$(topsrcdir)/remote`.
bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 15:18:42 +00:00
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
Full build mode
---------------
The remote agent supports only Firefox, and is included when you
build in the usual way:
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 15:18:09 +00:00
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
% ./mach build
When you make changes to XPCOM component files you need to rebuild
bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 15:18:42 +00:00
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
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
Component files include the likes of command-line-handler.js,
Bug 1572622 - Merge remote.js into all.js. r=ato This makes prefs definition simpler, more consistent, and less error-prone. Differential Revision: https://phabricator.services.mozilla.com/D41324 --HG-- extra : moz-landing-system : lando
2019-08-13 23:49:39 +00:00
RemoteAgent.manifest, moz.build files, and jar.mn.
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
All the JS modules (files ending with `.jsm`) are symlinked into
the build and can be changed without rebuilding.
You may also opt out of building the remote agent entirely by setting
the `--disable-cdp` build flag in your [mozconfig]:
ac_add_options --disable-cdp
Artifact mode
-------------
You may also use [artifact builds] when working on the remote agent.
This fast build mode downloads pre-built components from the Mozilla
build servers, rendering local compilation unnecessary. To use
them, place this in your [mozconfig]:
ac_add_options --enable-artifact-builds
bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 15:18:42 +00:00
[mozconfig]: ../build/buildsystem/mozconfigs.html
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
[artifact builds]: https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Build_Instructions/Artifact_builds
Reference in New Issue Copy Permalink