Skip to content

Commit

Permalink
docs(juggler/readme.md): more troubleshooting for ff on mac (#3813)
Browse files Browse the repository at this point in the history
Add docs/help for working around a bug when building firefox using the 
MacOSX SDK 10.14

Fixes #3812
  • Loading branch information
SlootSantos authored and aslushnikov committed Jan 19, 2019
1 parent 8426102 commit c48b574
Showing 1 changed file with 23 additions and 1 deletion.
24 changes: 23 additions & 1 deletion experimental/juggler/README.md
Expand Up @@ -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)
Expand Down

0 comments on commit c48b574

Please sign in to comment.