Repository files navigation

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.

Runsprebuildify in preconfiguredprebuild/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 andfiles) and mountsnode_modules removing the need for a repeatednpm install.

Depends on having Docker installed, as well asprebuildify andnode-gyp:

npm install --save-dev prebuildify node-gyp prebuildify-cross

Theprebuildify-cross cli forwards all command line arguments toprebuildify, but adds an--image or-i argument. For example, the following command will invokeprebuildify -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 defaultprebuild/docker-images are used which are publicly hosted on theGitHub 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 toghcr.io/prebuild/<image> and if these don't contain a tag they're further expanded toghcr.io/prebuild/<image>:<version> whereversion is currently 2.

To uselatest 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 thatprebuildify-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

• centos7-devtoolset7
• alpine
• linux-armv6
• linux-armv7
• linux-arm64
• android-armv7
• android-arm64

• Debian multiarch tuples
• Rust support tuples
• GCC flags
• Arm options
• Rust cross-compiling tutorial
• Rust cross-compilation tool

GPL-3.0