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.
Depends on having Docker installed, as well as prebuildify and node-gyp:
npm install --save-dev prebuildify node-gyp prebuildify-cross
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- Debian multiarch tuples
- Rust support tuples
- GCC flags
- Arm options
- Rust cross-compiling tutorial
- Rust cross-compilation tool
GPL-3.0