mozilla
/
gecko-dev
зеркало из https://github.com/mozilla/gecko-dev.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность
gecko-dev/remote/doc/Building.md

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

54 строки
1.7 KiB
Markdown
Исходник Обычный вид История

bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 18:18:42 +03:00
Building
========
bug 1544393: remote: ship remote agent in Firefox Nightly r=remote-protocol-reviewers,whimboo,maja_zf Now that the security review in bug 1542229 and the follow-up work that came out of it is complete, we should go ahead and flip the remote.enabled preference. This patch causes the remote agent to be available to users on the Firefox Nightly release channel. This meansusing --remote-debugger will no longer cause a fatal error Differential Revision: https://phabricator.services.mozilla.com/D55137 --HG-- extra : moz-landing-system : lando
2019-12-02 18:39:51 +03:00
The remote agent is included in the default Firefox build, but only
ships on the Firefox Nightly release channel:
bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 18:18:42 +03:00
Bug 1669230 - [remote] Remove --remote-debugger command line argument. r=remote-protocol-reviewers,jgraham Using different names for enabling the remote agent via --remote-debugger and --remote-debugging-port adds confusion to users. Also given that --remote-debugging is actually not used by any client library including Puppeteer, it can be removed. Using --remote-debugging-port instead will bring us onpar with Chrome and how it enables CDP. Differential Revision: https://phabricator.services.mozilla.com/D92603
2020-10-07 16:50:57 +03:00
% ./mach run --remote-debugging-port
bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 18:18:42 +03:00
bug 1544393: remote: ship remote agent in Firefox Nightly r=remote-protocol-reviewers,whimboo,maja_zf Now that the security review in bug 1542229 and the follow-up work that came out of it is complete, we should go ahead and flip the remote.enabled preference. This patch causes the remote agent to be available to users on the Firefox Nightly release channel. This meansusing --remote-debugger will no longer cause a fatal error Differential Revision: https://phabricator.services.mozilla.com/D55137 --HG-- extra : moz-landing-system : lando
2019-12-02 18:39:51 +03:00
The source code can be found under [remote/ in central].
There are two build modes to choose from:
bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 18:18:42 +03: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 20:18:22 +03: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 18:18:09 +03: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 20:18:22 +03: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 18:18:42 +03: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 1600081: remote: correct build instructions for startup r=remote-protocol-reviewers,whimboo With bug 1543115 we saw a rewrite of the startup code path in the remote agent. It forgot to update the build instructions to mention that changes to the Rust code requires you to have a full build available. DONTBUILD Differential Revision: https://phabricator.services.mozilla.com/D55130 --HG-- extra : moz-landing-system : lando
2019-11-28 22:42:58 +03:00
Component files include the likes of components.conf,
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-14 02:49:39 +03: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 20:18:22 +03:00
All the JS modules (files ending with `.jsm`) are symlinked into
the build and can be changed without rebuilding.
bug 1600081: remote: correct build instructions for startup r=remote-protocol-reviewers,whimboo With bug 1543115 we saw a rewrite of the startup code path in the remote agent. It forgot to update the build instructions to mention that changes to the Rust code requires you to have a full build available. DONTBUILD Differential Revision: https://phabricator.services.mozilla.com/D55130 --HG-- extra : moz-landing-system : lando
2019-11-28 22:42:58 +03:00
The remote agent’s startup code found under remote/startup/
is written in Rust and requires rebuilds when changed.
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 20:18:22 +03:00
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 18:18:42 +03:00
bug 1544393: remote: ship remote agent in Firefox Nightly r=remote-protocol-reviewers,whimboo,maja_zf Now that the security review in bug 1542229 and the follow-up work that came out of it is complete, we should go ahead and flip the remote.enabled preference. This patch causes the remote agent to be available to users on the Firefox Nightly release channel. This meansusing --remote-debugger will no longer cause a fatal error Differential Revision: https://phabricator.services.mozilla.com/D55137 --HG-- extra : moz-landing-system : lando
2019-12-02 18:39:51 +03:00
[remote/ in central]: https://searchfox.org/mozilla-central/source/remote
bug 1523104: remote: initial cdp prototype; r=ochameau
2019-01-29 18:18:42 +03: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 20:18:22 +03:00
[artifact builds]: https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Build_Instructions/Artifact_builds