prebuildify-cross
v5.1.1
Published
Compile prebuilds in Docker
Downloads
2,827
Readme
prebuildify-cross
Compile prebuilds in Docker, supporting Linux (including Debian 8, Ubuntu 14.04, RHEL 7, CentOS 7 and up), Alpine Linux, ARM Linux devices like the Raspberry Pi and mobile ARM devices like Android.
Runs prebuildify
in preconfigured prebuild/docker-images
containers to compile and name prebuilds for a certain platform. This means you don't have to worry about GCC flags, environment variables or system dependencies. In addition, prebuildify-cross
copies only npm package files to Docker (following the rules of .npmignore
and files
) and mounts node_modules
removing the need for a repeated npm install
.
Install
Depends on having Docker installed, as well as prebuildify
and node-gyp
:
npm install --save-dev prebuildify node-gyp prebuildify-cross
Usage
The prebuildify-cross
cli forwards all command line arguments to prebuildify
, but adds an --image
or -i
argument. For example, the following command will invoke prebuildify -t 8.14.0 --napi --strip
in a CentOS container and copy the resulting prebuild to ./prebuilds
:
prebuildify-cross -i centos7-devtoolset7 -t 8.14.0 --napi --strip
To build for more than one platform, multiple --image
arguments may be passed:
prebuildify-cross -i linux-armv7 -i linux-arm64 -t ..
By default prebuild/docker-images
are used which are publicly hosted on the GitHub Container Registry (ghcr.io
). It's possible to use custom images with e.g. -i my-namespace/my-image
. Image arguments that don't contain a forward slash are expanded to ghcr.io/prebuild/<image>
and if these don't contain a tag they're further expanded to ghcr.io/prebuild/<image>:<version>
where version
is currently 2.
To use latest
images (not recommended) an image tag must be specified explicitly. For example:
prebuildify-cross -i linux-armv7:latest -t ..
When working in a monorepo, where ./node_modules
does not contain the dependencies that prebuildify-cross
relies upon, a custom path can be provided with --modules
. It can be an absolute path or relative to the current working directory. For example:
prebuildify-cross --modules ../../node_modules -i linux-armv7:latest -t 20.0.0 --strip
Images
References
- Debian multiarch tuples
- Rust support tuples
- GCC flags
- Arm options
- Rust cross-compiling tutorial
- Rust cross-compilation tool
License
GPL-3.0