mirrors/nodejs
mirrors/nodejs
0
0
Fork 0
mirror of https://github.com/nodejs/node.git synced 2024-12-01 16:10:02 +01:00
Code Issues Releases Activity
8a60be4f0f
nodejs/doc/guides/maintaining-the-build-files.md
Denys Otrishko f90cf19fdd
doc: remove notice of dashes in V8 options 
Previously only V8 options supported both dashes in them (making them
equivalent), but now Node.js also supports both styles so the note can
be removed.

PR-URL: https://github.com/nodejs/node/pull/23903
Refs: https://github.com/nodejs/node/pull/18592
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: George Adams <george.adams@uk.ibm.com>
2018-10-29 21:24:08 +00:00

2.1 KiB
Raw Blame History

Maintaining the Build files

This document explains how to maintain the build files in the codebase.

Overview

On how to build the Node.js core, see Building Node.js.

There are three main build files that may be directly run when building Node.js:

  • configure: A Python 2 script that detects system capabilities and runs GYP. It generates config.gypi which includes parameters used by GYP to create platform-dependent build files. Its output is usually in one of these formats: Makefile, MSbuild, ninja, or XCode project files (the main Makefile mentioned below is maintained separately by humans). For a detailed guide on this script, see configure.
  • vcbuild.bat: A Windows Batch Script that locates build tools, provides a subset of the targets available in the Makefile, and a few targets of its own. For a detailed guide on this script, see vcbuild.bat.
  • Makefile: A Makefile that can be run with GNU Make. It provides a set of targets that build and test the Node.js binary, produce releases and documentation, and interact with the CI to run benchmarks or tests. For a detailed guide on this file, see Makefile.

On Windows vcbuild.bat runs configure before building the Node.js binary, on other systems configure must be run manually before running make on the Makefile.

vcbuild.bat

To see the help text, run .\vcbuild help. Update this file when you need to update the build and testing process on Windows.

configure

To see the help text, run python configure --help. Update this file when you need to update the configuration process.

Makefile

To see the help text, run make help. This file is not generated, it is maintained by humans. Note that this is not usually run on Windows, where vcbuild.bat is used instead.

Options

  • -j <n>: number of threads used to build the binary. Note that on the non-ci targets, the parallel tests will take up all the available cores, regardless of this option.