Platform Compatibility
Rad provides robust cross-platform compatibility with powerful platform management features to ensure your gems work correctly across different environments.
Supported Platforms
Rad officially supports the following platforms:
Operating Systems
- macOS (10.13+)
- Linux (glibc and musl)
- Windows (10+)
- FreeBSD
Architectures
- x86_64 (Intel/AMD 64-bit)
- aarch64 / arm64 (Apple Silicon)
- i686 (Intel/AMD 32-bit)
- armv7 (32-bit ARM)
Ruby Implementations
- MRI Ruby (2.0.0+)
- JRuby (9.0+)
- TruffleRuby
Ruby Managers
- RVM
- rbenv
- asdf
- chruby
Managing Platform-Specific Dependencies
Rad automatically handles platform-specific dependencies in your Gemfile. You can specify platform requirements using the platform option:
Platform Commands
Rad provides commands to help you manage and verify platform compatibility:
Listing Available Platforms
Checking Platform Compatibility
Installing for Specific Platform
Cross-Platform Compilation
When native extensions are required, Rad provides efficient handling of platform-specific gems:
To build gems for Linux while on macOS:
Platform Detection
Rad automatically detects your current platform, but you can also specify the target platform in configuration:
Multi-Platform Lockfiles
Rad automatically creates multi-platform lockfiles that ensure consistent dependencies across different environments. This is especially useful for projects that need to run on multiple operating systems or CI/CD pipelines.
Bundler Compatibility
Rad's lockfiles are compatible with Bundler, allowing seamless transitions between Rad and Bundler in multi-developer environments.
Next Steps
To learn more about platform-specific dependency management:
- Read about migrating from Bundler for smooth transitions
- Explore CI Integration for multi-platform builds
- Check the Command Reference for detailed platform commands