Spinel 部署指南5 步构建、安装与发布原生 Ruby 应用的完整教程【免费下载链接】spinelRuby AOT compiler项目地址: https://gitcode.com/gh_mirrors/spin/spinel一分钟了解Spinel 是一个Ruby AOT提前编译编译器能把 Ruby 源码直接编译成独立原生可执行文件生成的二进制不依赖 Ruby 运行时启动仅需约 0.8 毫秒基准测试中几何平均比启用 YJIT 的 CRuby 快约8.5 倍。本指南带你完成 Spinel 的构建、安装、发行与发布全流程。为什么选择 SpinelSpinel 的核心价值可以概括为一句话编译一次随处分发原生二进制。性能全程序类型推断 生成优化的 C 代码递归 fib 快 44 倍、矩阵乘法快 33 倍见 README.md 中的基准表零依赖分发生成程序只需 libc libm目标机器无需安装 Ruby整包发行依赖库spin packages的源码连同.c文件一起被编译进二进制双工具spinel是 gcc 风格的单文件编译器spin是 cargo 风格的项目管理器编译流水线一览源自 README.mdRuby (.rb) → 解析 (libprism) → 全程序类型推断 (analyze) → C 代码生成 (codegen) → cc -O2 → 原生二进制部署前准备环境要求Spinel 是一个自包含的单 C 二进制编译器构建与运行都不需要安装 CRubyCRuby 仅用于测试时做输出对照。你只需要依赖用途说明C 编译器构建编译器、编译生成代码gcc 或 clangmake构建自动化Makefile 驱动curl tar拉取 vendored 依赖仅make deps一次libprismRuby 解析器C 库make deps自动获取平台支持详见 docs/portability.md✅ Linuxx86-64、arm64gcc / clang✅ macOSIntel、Apple Siliconclang *BSD预期可用 Windows请通过 WSL 使用按 Linux 工具链构建第一步构建 Spinelmake 三连克隆源码仓库仓库地址https://gitcode.com/gh_mirrors/spin/spinel然后执行经典三步make deps # 拉取 libprism 等 vendored 依赖一次性 make # 构建 spinel 编译器 spin 项目工具 make test # 可选运行 3600 特性测试以 CRuby 为基准对照构建完成后会得到 bin/spinel 编译器本体以及 tools/spin.rb 编译出的spin项目工具。常用构建目标一览make bench— 与 CRuby 对比跑基准make clean— 清理构建产物make dist— 生成离线可构建的发行源码包spinel-release.tar.xz内含 vendored 解析器make一条命令即可离线构建 发行包采用日期标签命名YYYY.MM.DDspinel --version会显示所属版本、构建修订号与 C 编译器信息例如spinel 2026.09.12 (112bae85) [gcc 13.3.0]。第二步安装到系统构建成功后一条命令即可完成系统级安装sudo make install # 安装到 /usr/local sudo make install PREFIX~/.local # 或自定义前缀无需 rootmake install会做这些事见 Makefile 的 install 目标将spinel、spin、spinel_rbs_extract安装到PREFIX/lib/spinel/安装运行时库libspinel_rt.a含单线程与线程两个版本及全部头文件复制内置包packages/与 Ruby 核心方法builtins/在PREFIX/bin/创建spinel、spin及spinel-doctor、spinel-reduce等配套工具卸载同样简单make uninstall记得带上相同的PREFIX。第三步编译你的第一个原生二进制对于单文件脚本直接调用编译器即可——像用 gcc 一样简单./spinel app.rb # 编译生成 ./app 原生二进制 ./spinel app.rb -o myapp # 指定输出名 ./spinel app.rb -c # 只生成 C 源码不编译 ./spinel app.rb -S # 把生成的 C 打印到标准输出生成的二进制是完全独立的无 Ruby 解释器、无链式辅助程序可直接部署到任意同平台机器。更多命令行选项如--rbs DIR类型种子、--int-overflowwrap|raise|promote整数溢出策略参见 README.md 的 Single files 一节。第四步用 spin 管理完整项目当项目长大时切换到spin项目工具完整指南见 docs/spin.md——它负责脚手架、依赖解析、驱动编译你再也不用手写 Makefilespin new myapp # 脚手架spin.toml bin/myapp.rb test/ cd myapp spin run # 编译并运行 bin/myapp.rb spin add hello --version ~ 1.1 # 从索引添加依赖 spin add mylib --path ../mylib # 或本地路径 / git 仓库 spin test # 快照测试CRuby 为对照基准 spin build ./build/bin/myapp # 构建最终二进制项目结构按扩展名参与构建无需清单枚举myapp/ spin.toml # 清单名称、依赖 bin/myapp.rb # 每个 bin/*.rb 都是可执行入口 test/ # 每个 test/*.rb 都是快照测试 build/ # 可丢弃输出spin clean 清理✅测试哲学spin test采用快照对比——有.expected文件则比对输出没有则在 CRuby 下跑同一文件直接 diff天然兼作 CRuby 行为一致性检查。第五步发行与发布Publishing发布库到 spin 包索引如果你的项目是库一条命令即可发布版本见 docs/spin.mdspin publish它会依次完成校验版本已提交、[package] name/version齐全→强制运行spin test作为硬门槛→ 提交[[release]]条目锁定完整 commit SHA到索引。之后任何人都可以spin add mylib --version ~ 0.1使用你的库。注意一个版本只有一种写法0.1与0.1.0视为同一版本避免索引分裂。分发免编译器的源码包spin pack会打出一个只需 C 编译器 make的目录接收方无需安装 spinelspin pack # 生成含生成 C 源码、运行时源码、依赖 C 源码和 Makefile 的目录目标机器上make一下即得同样二进制。运行时以源码而非预编译库的形式随行保证跨平台交叉构建的一致性。发布编译器版本官方发行以日期 tagYYYY.MM.DD为标记make dist产出的 tarball 附带 vendored 解析器无网络也能构建——这是发布 Spinel 本体的标准方式。进阶跨目标发行WebAssembly除了本机原生二进制Spinel 还支持把 Ruby 程序发行到浏览器 / Node / wasmtimespinel --targetwasm32-wasi app.rb # 生成 app.wasm wasmtime run app.wasm需要 wasi-sdk≥34并先执行make wasm-rt构建目标运行时。注意 wasm32 目标下Integer为 32 位且不支持Thread/Fiber详见 docs/wasm.md。常见问题FAQQ1需要预装 Ruby 才能构建吗不需要。CRuby 只在测试框架中作对照基准构建与生成程序都只依赖 C 工具链。Q2gem install spinel为什么不存在Spinel 以源码形式发行make/make dist包不走 RubyGems 分发渠道。Q3哪些 Ruby 特性不能用AOT 模型下eval、method_missing、运行时define_method等动态元编程不支持完整清单见 docs/limitations.md。Q4CI 里如何保证质量make gate一次性跑完 test bench optcarrot 集成测试spinel diff app.rb可直接对比 CRuby 与 Spinel 的输出差异是提交 bug 报告的最佳起手式。总结部署路线一图流阶段命令产物构建make deps makespinelspin工具链安装sudo make install全局可用命令单文件spinel app.rb独立原生二进制项目spin new / run / buildbuild/bin/*可执行文件发布库spin publish索引中的版本化包离线发行make dist/spin pack无网络可构建的源码包延伸阅读docs/README.md 文档总目录、docs/FFI.md 直接调用 C 函数、docs/thread.md 无 GVL 线程模型、docs/int-overflow.md 整数溢出策略。现在就去构建你的第一个原生 Ruby 应用吧从make到spin publishSpinel 让 Ruby 应用像 C 程序一样被分发和部署。【免费下载链接】spinelRuby AOT compiler项目地址: https://gitcode.com/gh_mirrors/spin/spinel创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
