mirrors/electron
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions 2

docs: prefer out/Debug to out/Default in build docs

Browse source
This commit is contained in:
Jeremy Apthorp 2018-09-13 13:46:49 -07:00
parent 238ea29fa8
commit 9e85bdb02c
2 changed files with 22 additions and 22 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

42
docs/development/build-instructions-gn.md
View file

@ -79,36 +79,36 @@ $ cd src
$ export CHROMIUM_BUILDTOOLS_PATH=`pwd`/buildtools $ export CHROMIUM_BUILDTOOLS_PATH=`pwd`/buildtools
# this next line is needed only if building with sccache # this next line is needed only if building with sccache
$ export GN_EXTRA_ARGS="${GN_EXTRA_ARGS} cc_wrapper=\"${PWD}/electron/external_binaries/sccache\"" $ export GN_EXTRA_ARGS="${GN_EXTRA_ARGS} cc_wrapper=\"${PWD}/electron/external_binaries/sccache\""
$ gn gen out/Default --args="import(\"//electron/build/args/debug.gn\") $GN_EXTRA_ARGS" $ gn gen out/Debug --args="import(\"//electron/build/args/debug.gn\") $GN_EXTRA_ARGS"
``` ```
This will generate a build directory `out/Default` under `src/` with This will generate a build directory `out/Debug` under `src/` with
debug build configuration. You can replace `Default` with another name, debug build configuration. You can replace `Debug` with another name,
but it should be a subdirectory of `out`. but it should be a subdirectory of `out`.
Also you shouldn't have to run `gn gen` again—if you want to change the Also you shouldn't have to run `gn gen` again—if you want to change the
build arguments, you can run `gn args out/Default` to bring up an editor. build arguments, you can run `gn args out/Debug` to bring up an editor.
To see the list of available build configuration options, run `gn args To see the list of available build configuration options, run `gn args
out/Default --list`. out/Debug --list`.
**For generating Debug (aka "component" or "shared") build config of **For generating Debug (aka "component" or "shared") build config of
Electron:** Electron:**
```sh ```sh
$ gn gen out/Default --args="import(\"//electron/build/args/debug.gn\") $GN_EXTRA_ARGS" $ gn gen out/Debug --args="import(\"//electron/build/args/debug.gn\") $GN_EXTRA_ARGS"
``` ```
**For generating Release (aka "non-component" or "static") build config of **For generating Release (aka "non-component" or "static") build config of
Electron:** Electron:**
```sh ```sh
$ gn gen out/Default --args="import(\"//electron/build/args/release.gn\") $GN_EXTRA_ARGS" $ gn gen out/Debug --args="import(\"//electron/build/args/release.gn\") $GN_EXTRA_ARGS"
``` ```
**To build, run `ninja` with the `electron:electron_app` target:** **To build, run `ninja` with the `electron` target:**
```sh ```sh
$ ninja -C out/Default electron:electron_app $ ninja -C out/Debug electron
# This will also take a while and probably heat up your lap. # This will also take a while and probably heat up your lap.
``` ```
@ -117,19 +117,19 @@ This will build all of what was previously 'libchromiumcontent' (i.e. the
so it will take a while. so it will take a while.
To speed up subsequent builds, you can use [sccache][sccache]. Add the GN arg To speed up subsequent builds, you can use [sccache][sccache]. Add the GN arg
`cc_wrapper = "sccache"` by running `gn args out/Default` to bring up an `cc_wrapper = "sccache"` by running `gn args out/Debug` to bring up an
editor and adding a line to the end of the file. editor and adding a line to the end of the file.
[sccache]: https://github.com/mozilla/sccache [sccache]: https://github.com/mozilla/sccache
The built executable will be under `./out/Default`: The built executable will be under `./out/Debug`:
```sh ```sh
$ ./out/Default/Electron.app/Contents/MacOS/Electron $ ./out/Debug/Electron.app/Contents/MacOS/Electron
# or, on Windows # or, on Windows
$ ./out/Default/electron.exe $ ./out/Debug/electron.exe
# or, on Linux # or, on Linux
$ ./out/Default/electron $ ./out/Debug/electron
``` ```
### Cross-compiling ### Cross-compiling
@ -139,7 +139,7 @@ set the `target_cpu` and `target_os` GN arguments. For example, to compile an
x86 target from an x64 host, specify `target_cpu = "x86"` in `gn args`. x86 target from an x64 host, specify `target_cpu = "x86"` in `gn args`.
```sh ```sh
$ gn gen out/Default-x86 --args='... target_cpu = "x86"' $ gn gen out/Debug-x86 --args='... target_cpu = "x86"'
``` ```
Not all combinations of source and target CPU/OS are supported by Chromium. Not all combinations of source and target CPU/OS are supported by Chromium.
@ -161,27 +161,27 @@ generate build headers for the modules to compile against, run the following
under `src/` directory. under `src/` directory.
```sh ```sh
$ ninja -C out/Default third_party/electron_node:headers $ ninja -C out/Debug third_party/electron_node:headers
# Install the test modules with the generated headers # Install the test modules with the generated headers
$ (cd electron/spec && npm i --nodedir=../../out/Default/gen/node_headers) $ (cd electron/spec && npm i --nodedir=../../out/Debug/gen/node_headers)
``` ```
Then, run Electron with `electron/spec` as the argument: Then, run Electron with `electron/spec` as the argument:
```sh ```sh
# on Mac: # on Mac:
$ ./out/Default/Electron.app/Contents/MacOS/Electron electron/spec $ ./out/Debug/Electron.app/Contents/MacOS/Electron electron/spec
# on Windows: # on Windows:
$ ./out/Default/electron.exe electron/spec $ ./out/Debug/electron.exe electron/spec
# on Linux: # on Linux:
$ ./out/Default/electron electron/spec $ ./out/Debug/electron electron/spec
``` ```
If you're debugging something, it can be helpful to pass some extra flags to If you're debugging something, it can be helpful to pass some extra flags to
the Electron binary: the Electron binary:
```sh ```sh
$ ./out/Default/Electron.app/Contents/MacOS/Electron electron/spec \ $ ./out/Debug/Electron.app/Contents/MacOS/Electron electron/spec \
--ci --enable-logging -g 'BrowserWindow module' --ci --enable-logging -g 'BrowserWindow module'
``` ```

2
script/lib/utils.js
View file

@ -1,4 +1,4 @@
const OUT_DIR = process.env.ELECTRON_OUT_DIR || 'Default' const OUT_DIR = process.env.ELECTRON_OUT_DIR || 'Debug'
const path = require('path') const path = require('path')