33ef0d23a6
* docs: fix minor grammar error 'punctuations' * docs: fix minor grammar error pluralizing Chromium * docs: fix typo 'updateCurrentActiviy' * docs: use consistent spelling of 'behavior' * docs: use 'macOS' instead of 'Mac OS' or 'OS X'. * docs: use 'GTK' instead of 'GTK+' https://mail.gnome.org/archives/gtk-devel-list/2019-February/msg00000.html * docs: minor capitalization: use 'TCP' not 'tcp' * Update docs/development/build-instructions-linux.md Co-Authored-By: Mark Lee <malept@users.noreply.github.com> Co-authored-by: Mark Lee <malept@users.noreply.github.com> Co-authored-by: John Kleinschmidt <jkleinsc@github.com>
49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
# Build Instructions (macOS)
|
|
|
|
Follow the guidelines below for building Electron on macOS.
|
|
|
|
## Prerequisites
|
|
|
|
* macOS >= 10.11.6
|
|
* [Xcode](https://developer.apple.com/technologies/tools/) >= 9.0.0
|
|
* [node.js](https://nodejs.org) (external)
|
|
* Python 2.7 with support for TLS 1.2
|
|
|
|
## Python
|
|
|
|
Please also ensure that your system and Python version support at least TLS 1.2.
|
|
This depends on both your version of macOS and Python. For a quick test, run:
|
|
|
|
```sh
|
|
$ npx @electron/check-python-tls
|
|
```
|
|
|
|
If the script returns that your configuration is using an outdated security
|
|
protocol, you can either update macOS to High Sierra or install a new version
|
|
of Python 2.7.x. To upgrade Python, use [Homebrew](https://brew.sh/):
|
|
|
|
```sh
|
|
$ brew install python@2 && brew link python@2 --force
|
|
```
|
|
|
|
If you are using Python as provided by Homebrew, you also need to install
|
|
the following Python modules:
|
|
|
|
* [pyobjc](https://pypi.org/project/pyobjc/#description)
|
|
|
|
You can use `pip` to install it:
|
|
|
|
```sh
|
|
$ pip install pyobjc
|
|
```
|
|
|
|
## macOS SDK
|
|
|
|
If you're developing Electron and don't plan to redistribute your
|
|
custom Electron build, you may skip this section.
|
|
|
|
Official Electron builds are built with [Xcode 9.4.1](http://adcdownload.apple.com/Developer_Tools/Xcode_9.4.1/Xcode_9.4.1.xip), and the macOS 10.13 SDK. Building with a newer SDK works too, but the releases currently use the 10.13 SDK.
|
|
|
|
## Building Electron
|
|
|
|
See [Build Instructions: GN](build-instructions-gn.md).
|