From 583d1ff636a0232edf927704014ccf5dc10042eb Mon Sep 17 00:00:00 2001 From: Carlos Duarte Do Nascimento Date: Wed, 6 Dec 2023 08:54:49 +0000 Subject: [PATCH] Bug 1867857 - Add instructions to source documentation for testing in other Macs by packaging. r=sylvestre DONTBUILD When I had to test a change in another macOS version, I naively copied the `Nightly.app` to another computer, just to find out it silently fails (because of symlinked libraries) and it took a while (and external help) to figure that out. This change instructs developers to package and use the `.dmg` instead when they want to do that, sparing the frustration and incentivizing testing in different systems. Differential Revision: https://phabricator.services.mozilla.com/D195319 --- docs/setup/macos_build.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/setup/macos_build.rst b/docs/setup/macos_build.rst index affc0e9396da..df3719e6481b 100644 --- a/docs/setup/macos_build.rst +++ b/docs/setup/macos_build.rst @@ -118,6 +118,17 @@ You can now use the ``./mach run`` command to run your locally built Firefox! If your build fails, please reference the steps in the `Troubleshooting section <#troubleshooting>`_. +Running outside the development environment +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +To test your changes on another macOS system (or to keep that particular Firefox around after new builds), you can't just use the generated application bundle (``obj-*/dist/Nightly[Debug].app``), since it contains symbolic links to other built libraries. Instead, build a distributable disk image with: + +.. code-block:: shell + + ./mach package + +Copy the resulting ``.dmg`` file from ``obj-*/dist/`` to the target system, then double-click it as usual to find an ``.app`` bundle containing all dependencies. + Now the fun starts ------------------