de441916d6
I added a mention of `cpplint.py` in the build instructions. The reason, is because it's easy to miss it's existence. Even if you noticed it's mentioned in `coding-style.md` you might mistakenly think that `test.py` runs it).
64 lines
1.1 KiB
Markdown
64 lines
1.1 KiB
Markdown
# Build instructions (Mac)
|
|
|
|
## Prerequisites
|
|
|
|
* OS X >= 10.8
|
|
* [Xcode](https://developer.apple.com/technologies/tools/) >= 5.1
|
|
* [node.js](http://nodejs.org) (external).
|
|
|
|
If you are using the python downloaded by Homebrew, you also need to install
|
|
following python modules:
|
|
|
|
* pyobjc
|
|
|
|
## Getting the code
|
|
|
|
```bash
|
|
$ git clone https://github.com/atom/electron.git
|
|
```
|
|
|
|
## Bootstrapping
|
|
|
|
The bootstrap script will download all necessary build dependencies and create
|
|
build project files. Notice that we're using `ninja` to build Electron so
|
|
there is no Xcode project generated.
|
|
|
|
```bash
|
|
$ cd electron
|
|
$ ./script/bootstrap.py -v
|
|
```
|
|
|
|
## Building
|
|
|
|
Build both `Release` and `Debug` targets:
|
|
|
|
```bash
|
|
$ ./script/build.py
|
|
```
|
|
|
|
You can also only build the `Debug` target:
|
|
|
|
```bash
|
|
$ ./script/build.py -c D
|
|
```
|
|
|
|
After building is done, you can find `Electron.app` under `out/D`.
|
|
|
|
## 32bit support
|
|
|
|
Electron can only be built for 64bit target on OS X, and there is no plan to
|
|
support 32bit OS X in future.
|
|
|
|
## Tests
|
|
|
|
Test your changes confirm to the project coding style using:
|
|
|
|
```bash
|
|
$ ./script/cpplint.py
|
|
```
|
|
|
|
Test functionality using:
|
|
|
|
```bash
|
|
$ ./script/test.py
|
|
```
|