nagai/fune
3
0
Fork 0
forked from mirrors/gecko-dev
Code Pull requests Activity

Bug 1867857 - Add instructions to source documentation for testing in other Macs by packaging. r=sylvestre DONTBUILD

Browse source 
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
This commit is contained in:
Carlos Duarte Do Nascimento 2023-12-06 08:54:49 +00:00
parent 7fb6dc20f7
commit 583d1ff636
1 changed files with 11 additions and 0 deletions
repo.diff.show_diff_stats Download patch file Download diff file Expand all files Collapse all files

11
docs/setup/macos_build.rst
View file

@ -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
------------------