rbsys/x86_64-linux-musl Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

rb-sys

镜像概述和主要用途

rb-sys 的主要目标是让使用 Rust 构建 Ruby 原生扩展比使用 C 更简单。如果使用过程不便捷，那就是一个需要修复的问题。

核心功能和特性

rb-sys 包含以下组件：

• rb-sys crate：经过实战检验的 Ruby C API Rust 绑定
• rb_sys gem：简化将 Rust 代码编译为 Ruby 扩展的过程
• rb-sys-test-helpers：用于从 Rust 测试 Ruby 扩展的工具集
• rb-sys-dock：基于 Docker 的交叉编译工具

支持的工具链

• Ruby：2.6+
• Rust：1.65+

使用场景和适用范围

rb-sys 适用于需要构建高性能 Ruby 原生扩展的场景，尤其适合：

• Rust 开发者希望为 Ruby 生态系统贡献扩展
• 需要跨平台支持的 Ruby 扩展开发
• 追求内存安全和现代语言特性的 Ruby 扩展项目
• 替代传统 C 编写的 Ruby 扩展，提升开发效率和代码质量

使用方法和配置说明

有关详细的使用文档，请参考 Ruby on Rust 手册，其中涵盖：

• 入门指南和快速开始教程
• 如何处理 Ruby 对象、类和模块
• 内存管理与安全
• 跨平台开发
• 测试与调试
• rb-sys crate 和 rb_sys gem 的 API 参考

实际应用示例

以下是使用 rb-sys 的真实项目示例：

• oxi-test - rb-sys 使用的标准示例（最小化、经过测试、支持交叉编译）
• blake3-ruby - 快速加密哈希函数
• wasmtime-rb - 结合 rb-sys 和 Magnus 的 WebAssembly 运行时
• lz4-ruby - LZ4 压缩库

获取帮助

• 加入 Oxidize Ruby Slack 并在 #general 频道提问
• 在 GitHub 上 提交 issue

贡献指南

有关设置开发环境的信息，请参见 CONTRIBUTING.md 文件。

许可证

本项目采用以下任一许可证授权：

• Apache 许可证 2.0（LICENSE-APACHE）
• MIT 许可证（LICENSE-MIT）

您可以选择任一许可证。