openRuyi 文档中心
欢迎来到 openRuyi 文档中心。本仓库旨在为开发者和打包者提供全方位的技术指引，确保软件包的质量与一致性。
🚀 快速入门
如果你是第一次参与 openRuyi 的开发或打包，请先阅读以下指南:
- openRuyi 开发者贡献指南: 了解如何提交代码及参与社区贡献。
-
打包 & 修包快速入门: 让你几分钟上手第一个软件包。
-
Pre-commit 使用指南: 确保你的软件包符合提交规范。
📜 软件包构建规范
这些是打包的核心准则，所有软件包应以基于 openRuyi Packaging Specification 为基准，并参考以下细化指南进行构建。
元数据
-
许可证 & SPDX 许可证表达式: 详细介绍许可证机制。
-
宏标签: 规范 RPM Spec 中的变量定义。
文件与构建行为
-
源码包: 上游源码在 RPM Spec 内的编写策略。
-
补丁: 如何管理和应用 Patch。
-
脚本: 控制
%pre,%post等安装前后脚本的行为。 -
字体打包指南: 字体包命名、许可证、安装位置与子包拆分指南。
包组织与其它特性
🧪 质量门禁与审阅
了解软件包在合并前需要通过的自动化检查与人工审计策略。
-
软件包审阅指南: 详细说明了 CI/CD 门禁的检查项、准入标准及常见打回原因。
-
使用 pkgconfig(xxx): 规范依赖追踪，避免硬编码依赖。
📚 语言专项与构建系统
针对特定编程语言和工具链的实践建议。
| 类别 | 详细指南 | 声明式构建系统 |
|---|---|---|
| C/C++ | autotools / meson | |
| Python | Python 打包指南 | |
| Perl | Perl 打包指南 | |
| Golang | Golang 打包指南 | Golang |
🤝 参与完善
如果你发现规范中存在遗漏或需要更新，请提交 Issue 告诉我们！