Node CMake
A CMake-based build system for Node.js native modules, for CMake >= v3.1.
Newly rewritten for 2.0!
New Features
- Drop-in execution compatibility with the
node-gypbinary - Standardization with the
node-gypoutput and format. Should work better with tools that expect node-gyp's behaviour - Simplified, portable and customizable configuration script
- Better recovery from failed downloads and builds
- Generalized support for Node.js variants. This supports additional variant types that are compatible with the Node.js release server structure (SHAs defined for all resources hosted on the download server, headers and .lib files located in standard locations).
Removed Features
find_packagesupport. The module loading technique used in 1.0 was flawed for specific module structures and setup (deeply nested native dependencies). The new technique is to runncmake updateto copy the configuration script into your project. This means that projects will not stay in sync with updates automatically. Be sure to runncmake updatewhen updatingnode-cmaketo a new version.ncmakecommand line arguments.ncmakenow follows and extends thenode-gypcommand line interface. Please update your build files to use the new syntax (ncmake --build=>ncmake rebuild). For more info, see the manual.- Support for NW.js - The NW.js release server is not compliant to the Node.js release server structure. Workaround for the NW.js naming conventions have been included in the update, but the server SHA file does not include checksums for all resources, leaving no way to validate downloads. The SHASUMS256.txt file on the server needs to be updated to include these entries to be used with this tool.
Usage
To use this package, add the module node-cmake to your package.json as a development dependency:
npm install --save-dev node-cmake
Run ncmake update to copy the file NodeJS.cmake from this module into your project. Then add a CMakeLists.txt file to the root of your module that contains at least the following (<REPLACE> with your own definitions):
cmake_minimum_required(VERSION 3.1)
project(<NAME OF MODULE> VERSION 1.0.0)
include(NodeJS.cmake)
nodejs_init()
add_nodejs_module(${PROJECT_NAME} <SOURCE AND HEADER FILES GO HERE>)
This CMakeLists.txt file is the main build script for CMake, and replaces your existing binding.gyp file from node-gyp. It defines the build process for this project, including how to configure Node.js, and how to build your project components (modules, libraries, etc.)
The NodeJS.cmake file, included by relative path in this example, is a self-contained configuration tool for downloading the dependencies for building Node.js native modules, and configuring cmake to build them:
nodejs_init configures the version of Node.js to use for building. By default, this is the currently installed version of node on your platform. This function can take a number of advanced options (see Documentation). This function must be called before any other function provided by the script.
add_nodejs_module is a helper function for configuring CMake to build a node module based on the currently configured version of node. It takes the name of a target to create, along with a list of source files to build. All arguments after the target name are treated as sources.
CMake has extensive documentation online, which can be found here.
Building
node-cmake has been updated to provide a drop-in replacement for node-gyp's interface. To build your module, use the command ncmake rebuild, which cleans, configures and builds the module.
This can be integrated into npm via its "scripts" directive:
"scripts": {
"install": "ncmake rebuild"
}
Running
node-cmake also provides a simple javascript module to simplify the finding and loading of the built native module in your own scripts. It exposes a single function similar to require with the same effects. Calling
require('node-cmake')('<NAME OF MODULE>')
will load and return the named native module by searching in standard build locations. A second boolean can be passed to this function to configure loading of debug builds by default (if available).
Example
An example project is provided in the example folder. Follow the directions in its README.md to build it correctly.
Documentation
Motivation
This tool was developed as a replacement for node-gyp, the current Node.js build system. Google has stopped working on its core, the gyp build tool, to focus on its replacement gn and the future of gyp is uncertain.
CMake also provides a number of benefits over gyp:
- Does not depend on python
- Extensive cross-platform utilities for finding and using other libraries and packages (the find_* family of commands, and the package system).
- Native IDE support (CLion, KDevelop), and good support for platform IDEs (Visual Studio, Xcode, Eclipse)
- Easy integration with other projects and build systems
- Cross-compilation via toolchains
51 Apr 6, 2022
128 Dec 17, 2022
115 Dec 5, 2022
![The Lua Language distribution [Archived]](https://avatars.githubusercontent.com/u/253461?v=4&s=40)
1.4k Dec 30, 2022
60 Dec 21, 2022
83 Nov 28, 2022
5 Sep 5, 2022
36 Oct 28, 2022
0 Feb 15, 2022
21 Dec 10, 2022
2 Jan 2, 2022
20 Aug 2, 2022
17 Oct 10, 2022
57 Nov 30, 2022
200 Dec 22, 2022
1.9k Jan 5, 2023
4 Jun 24, 2022
72 Nov 25, 2022