Skip to content

Latest commit

 

History

History
67 lines (47 loc) · 2.42 KB

readme.md

File metadata and controls

67 lines (47 loc) · 2.42 KB
Raw

xrubies

WIP to make cross-compiling native Ruby gems easier. You can find the latest builds here.

Usage

Just to prove it works

$ docker run --rm -it ghcr.io/oxidize-rb/aarch64-linux:3.1-ubuntu \
  /opt/xrubies/3.1/bin/ruby -v
ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [aarch64-linux-gnu]

docker run --rm -it ghcr.io/oxidize-rb/x86_64-linux:3.2-rc1-centos \
  /opt/xrubies/3.2/bin/ruby -v
ruby 3.2.0rc1 (2022-12-06 master 81e274c990) [x86_64-linux-gnu]

Building a custom image

FROM ghcr.io/oxidize-rb/arch64-linux:3.2-centos

// Whatever you want...

RUN /opt/xrubies/3.2/bin/ruby -v

FAQ

How is this different than rake-compiler-dock?

This tool takes a lot of inspiration from rake-compiler-dock, but differs in a few key ways.

  1. The rubies in this project are blissfully unaware of the host system (i.e. --host == --build == --target). Ruby is treated as a "regular", native compiled Ruby. This means we never have to fake any values in RbConfig or rbconfig.rb.

  2. You can actually execute the Ruby binaries like normal. This means you can run rake test as you normally would, and it will work. To accomplish this, we directly leverage qemu to emulate the target architecture.

  3. Each version of includes all of the normal extensions (openssl, libyaml, etc.) and vendors them so they do not need to be installed on the host system. As a side benefit, the compiled Ruby binaries should be shareable if someone wants to use another build container.

  4. Images are based on the cross-rs Docker images, which have great support for Rust and an huge variety of supported architectures.

  5. (Eventually) will have full support for M1 macOS builds, without emulation. This means Rust compilation times will be much faster on Apple Silicon.

  6. (Eventually) will support the ability the vendor dylibs installed used by gems by using. We already do this for libruby using patchelf, but we can do the same for other gems. This is what auditwheel does for python.

  7. Only supports non-EOL versions of Ruby.