Use Native Node Modules {: .doctitle}
Install with NPM
For LTS Releases
Use Same Version and Architecture of Node.js and NW.js
Following instructions only works if you are using the same version and architecture of Node.js and NW.js.
If you are using LTS release, native modules installed by npm
can be supported after hacking as below:
- On Linux and Mac, no hacking is required.
- On Windows, you need to replace the file
<npm-path>\node_modules\node-gyp\src\win_delay_load_hook.cc
with the one at https://github.com/nwjs/nw.js/blob/nw18/tools/win_delay_load_hook.cc before installing modules with node-gyp or npm.
For non-LTS Releases
If you are using non-LTS release, nw-gyp
is required to be pre-installed globally to build modules due to ABI differences in V8. These instructions below works for LTS releases as well.
To install native modules for NW.js, run following commands in your terminal:
# Install nw-gyp globally
npm install -g nw-gyp
# Setup target NW.js version
export npm_config_target=0.18.5
# Setup build architecture, ia32 or x64
export npm_config_arch=x64
export npm_config_target_arch=x64
# Setup env for modules built with node-pre-gyp
export npm_config_runtime=node-webkit
export npm_config_build_from_source=true
# Setup nw-gyp as node-gyp
export npm_config_node_gyp=$(which nw-gyp)
# Run npm install
npm install
Note for Windows
You will need to have a compiler installed. You can get one by installing the Visual C++ Build Tools. You will also need Python 2.7 (version 3.x is not supported).
The npm_config_node_gyp
environment variable has to be set to path\to\global\node_modules\nw-gyp\bin\nw-gyp.js
instead of the nw-gyp.cmd
batch script. This is a bug of npm.
You must use set
instead of export
to set environment variables in Windows. Here is a full example (Windows 10, Visual C++ Build Tool v2015):
set PYTHON=C:\Python27\python.exe
set npm_config_target=0.21.6
set npm_config_arch=x64
set npm_config_runtime=node-webkit
set npm_config_build_from_source=true
set npm_config_node_gyp=C:\Users\xxxxxxxxx\AppData\Roaming\npm\node_modules\nw-gyp\bin\nw-gyp.js
npm install --msvs_version=2015
Manually Rebuild
Full NPM Install is Recommended
After a version switch of NW.js, the recommended approach is to delete node_modules
folder and do a full npm install as the instructions above.
Once you switch to a new version of NW.js, you can rebuild each of the native modules with the tools below without reinstall all the modules. Since binding.gyp
is required for building native modules, you can easily locate all native modules by finding binding.gyp
file.
Rebuild ALL Native Modules
Make sure you rebuilt all native modules. Or you will meet various issues, even crashes. Once manually rebuild don’t work for you, try to do a full npm install.
nw-gyp
nw-gyp
is a hack on node-gyp
to support NW.js specific headers and libraries.
The usage is the same with node-gyp
, except that you need to specify the version and arch (x64
or ia32
) of NW.js manually.
npm install -g nw-gyp
cd myaddon
nw-gyp rebuild --target=0.13.0 --arch=x64
See https://github.com/nwjs/nw-gyp for more details.
node-pre-gyp
Some packages uses node-pre-gyp, which supports building for both Node.js and NW.js by using either node-gyp
or nw-gyp
.
The usage of node-pre-gyp
is as following:
npm install -g node-pre-gyp
cd myaddon
node-pre-gyp build --runtime=node-webkit --target=0.13.0 --target_arch=x64
See https://github.com/mapbox/node-pre-gyp for more details.