From c48b5749f520d75239bb3ee54aa0e300a6f6d866 Mon Sep 17 00:00:00 2001 From: Flosloot Date: Sat, 19 Jan 2019 20:14:39 +0100 Subject: [PATCH] docs(juggler/readme.md): more troubleshooting for ff on mac (#3813) Add docs/help for working around a bug when building firefox using the MacOSX SDK 10.14 Fixes #3812 --- experimental/juggler/README.md | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/experimental/juggler/README.md b/experimental/juggler/README.md index b7077671b77..3aede5477e9 100644 --- a/experimental/juggler/README.md +++ b/experimental/juggler/README.md @@ -37,7 +37,29 @@ ln -s $PWD/../src $PWD/testing/juggler ./mach build ``` -### Troubleshooting when building FF +### Troubleshooting when building FF on Mac +#### Black screen after FF Build +As of Jan. 2019 there is a known [bug](https://bugzilla.mozilla.org/show_bug.cgi?id=1493330) that will cause an entirely black screen when running the nightly build of firefox built with the **MacOSX SDK version 10.14.** + +The easiest fix right now is downgrading your MacOSX SDK. + +To do so: + +1) Go to [this repo](https://github.com/phracker/MacOSX-SDKs) and install any **SDK version < 10.14** (e.g. 10.13 works fine) + +2) In the `juggler/firefox` folder: + +```bash +echo "ac_add_options --with-macos-sdk=path/to/sdk" >> .mozconfig +# your SDK might be located at +# /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/ +``` + +3) run `./mach build` again + + +#### Missing headers in /usr/include + On MacOS 10.14 (Mojave) you might run into issues when building FF. The error is related to [a change in the xcode-select installation](https://bugzilla.mozilla.org/show_bug.cgi?id=1487552)