Merge pull request #32940 from MatrixAI/nodepackagesreadme

nodePackages: Added instructions to README about packages with binary addons
This commit is contained in:
Sander van der Burg 2017-12-21 14:33:44 +01:00 committed by GitHub
commit 8135068dfe
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -17,6 +17,23 @@ is that a new package should be added to the collection for the latest stable LT
release (which is currently 6.x), unless there is an explicit reason to support release (which is currently 6.x), unless there is an explicit reason to support
a different release. a different release.
If your package uses native addons, you need to examine what kind of native
build system it uses. Here are some examples:
* `node-gyp`
* `node-gyp-builder`
* `node-pre-gyp`
After you have identified the correct system, you need to override your package
expression while adding in build system as a build input. For example, `dat`
requires `node-gyp-build`, so we override its expression in `default-v6.nix`:
```nix
dat = nodePackages.dat.override (oldAttrs: {
buildInputs = oldAttrs.buildInputs ++ [ nodePackages.node-gyp-build ];
});
```
To add a package from NPM to nixpkgs: To add a package from NPM to nixpkgs:
1. Modify `pkgs/development/node-packages/node-packages-v6.json` to add, update 1. Modify `pkgs/development/node-packages/node-packages-v6.json` to add, update