Debian 新维护者手册

• 语言: 中文（简体）
• 格式: .pdf
• 来源: www.debian.org

摘要

《Debian新维护者手册》旨在指导用户制作和维护Debian软件包。文档详细介绍了Debian软件包系统的重要性、制作流程、所需工具和文档，以及如何处理不同复杂度的软件包。内容涵盖从简单软件包到高复杂度软件包的打包方法，并强调了维护者脚本、许可证合规性、软件包分类等关键事项。文档还提供了如何更新和上传软件包的指导，并附带了多个实际例子和工具使用说明。

AI总结

《Debian 新维护者手册》是一份旨在帮助用户制作和维护Debian软件包的教程文档，内容涵盖了从入门到高级打包的各个方面。以下是文档的核心内容总结：

---

### **1. 正确的起点**
- **目标用户**：普通用户和开发者，旨在制作和维护Debian软件包。
- **技术基础**：需要一定的Unix编程知识，但无需成为专家。
- **社会驱动力**：
- Debian是一个志愿者驱动的社区。
- 参与Debian需要良好的技术基础、勤奋和适应能力。
- 社区角色包括上游作者、维护者、赞助者、导师和开发者（DD）。

---

### **2. 软件包制作流程**
- **选择程序**：
- 优先选择简单、易于维护的程序。
- 确保程序符合Debian的自由软件准则（DFSG）。
- 避免选择无人维护或涉及安全问题的程序。
- **获取和试用**：
- 下载源代码并试用，确保程序功能正常。
- **编译系统**：
- 使用`dh_make`工具初始化Debian软件包。
- 配置编译环境，确保程序能够在Debian系统上编译。
- **命名和版本**：
- 软件包名称应简洁明了，版本号需符合语义化版本控制。
- **初始化Debian包**：
- 创建`debian`目录，包含必要的文件（如`control`、`changelog`、`rules`等）。

---

### **3. 修改源代码**
- **使用quilt**：
- quilt是一个代码补丁管理工具，用于跟踪和管理源代码的修改。
- **修复上游Bug**：
- 在源代码中修复已知问题，并记录修复内容。
- **文件安装**：
- 确保文件正确安装到目标目录，避免文件权限和路径问题。
- **维护者脚本**：
- 编写`preinst`、`postinst`、`prerm`和`postrm`脚本，处理软件包的安装、卸载和配置。
- 避免在升级时打扰用户，尽量使用静默安装。

---

### **4. debian目录中的必需内容**
- **control文件**：
- 包含软件包的元数据，如来源、分类、依赖项和描述。
- **copyright文件**：
- 记录软件包的版权声明和许可信息。
- **changelog文件**：
- 记录软件包的版本更新日志，遵循Debian日志格式。
- **rules文件**：
- 定义构建过程中的目标和规则，通常使用`dh`系列命令简化构建流程。

---

### **5. 上传软件包**
- **上传到Debian仓库**：
- 软件包需符合Debian政策，确保其安全性和可维护性。
- 使用`debuild`或`pbuilder`等工具构建和签名软件包。
- **包含orig.tar.gz文件**：
- 上传上游源代码包，便于审核和重新构建。
- **跳过的上传**：
- 避免上传不符合政策或存在严重问题的软件包。

---

### **6. 高级打包**
- **共享库**：
- 处理共享库时需管理`debian/package.symbols`文件，确保符号兼容性。
- **多体系结构**：
- 使用交叉编译工具支持多种架构。
- **本地软件包**：
- 针对Debian本土软件的打包策略。

---

### **7. 其他重要信息**
- **文档和工具**：
- 使用`uscan`和`watch`文件监控上游源代码更新。
- 遵循`debian/source/format`定义源代码包的格式。
- **社区资源**：
- 参考Debian官方文档、邮件列表和Wiki获取帮助。
- 通过赞助者或导师上传软件包。

---

### **总结**
《Debian 新维护者手册》为新手提供了从零开始制作和维护Debian软件包的详细指南。内容涵盖从基础流程到高级打包技巧，强调了社区合作、文档规范和代码管理的重要性。对于希望为Debian社区贡献力量的用户，这是一份实用的入门指导。