rbsys/x86_64-linux Docker 镜像 - 轩辕镜像

rb-sys

镜像概述和主要用途

rb-sys的核心目标是简化使用Rust构建Ruby原生扩展的过程，使其比使用C语言更便捷。它提供了完整的工具链支持，包括Rust绑定、编译工具、测试 utilities 以及Docker交叉编译工具，帮助开发者高效开发高性能、跨平台的Ruby扩展。

核心功能和特性

主要组件

• rb-sys crate：经过实战验证的Ruby C API Rust绑定库
• rb_sys gem：简化Rust代码编译为Ruby扩展的工具
• rb-sys-test-helpers：用于从Rust测试Ruby扩展的实用工具集
• rb-sys-dock：基于Docker的交叉编译工具，支持跨平台扩展开发

支持的工具链版本

• Ruby：2.7+
• Rust：1.71+

使用场景和适用范围

• 开发高性能Ruby原生扩展（如加密算法、压缩库等）
• 构建跨平台Ruby扩展，需在多系统环境运行
• 替代C语言开发Ruby扩展，利用Rust的内存安全和性能优势
• 需要简化扩展测试、调试流程的Ruby项目

详细使用方法和配置说明

基础使用指南

完整文档请参考Ruby on Rust Book，涵盖以下核心内容：

• 快速入门教程和基础配置
• Ruby对象、类、模块的Rust操作方法
• 内存管理与安全最佳实践
• 跨平台开发流程
• 测试与调试技巧
• rb-sys crate和rb_sys gem的API参考

Docker交叉编译工具（rb-sys-dock）

rb-sys-dock提供Docker化的交叉编译环境，简化多平台Ruby扩展的构建流程。具体使用方法请参考官方文档中"跨平台开发"章节，包含环境配置、编译命令和产物管理等内容。

实际应用示例

• oxi-test：rb-sys标准使用示例（最小化配置、完整测试、支持交叉编译）
• blake3-ruby：基于rb-sys开发的高性能加密哈希函数扩展
• wasmtime-rb：结合rb-sys与Magnus开发的WebAssembly运行时
• lz4-ruby：使用rb-sys构建的LZ4压缩库扩展

获取帮助

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

贡献

开发环境搭建相关信息，请参见CONTRIBUTING.md。

许可协议

可选择以下任一许可协议：

• Apache License, Version 2.0（LICENSE-APACHE）
• MIT许可协议（LICENSE-MIT）

按个人需求选择适用许可。