Debian 新維護人員手冊

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

摘要

文档详细介绍了Debian新维护人员在软件包构建和维护过程中使用的命令行工具和方法。其中包括dpkg-buildpackage、pbuilder、debuild等核心构建工具的应用，debc命令用于列出二进制软件包内容，lintian用于检查软件包的错误和警告。文档还介绍了如何在Chroot环境中构建软件包，如何处理安装和脚本测试，以及如何使用debdiff和interdiff比较不同版本的软件包内容。)

AI总结

《Debian 新維護人員手冊》總結

本文主要圍繞Debian軟體包的維護、構建工具及錯誤檢查方法進行講解，以下是核心內容的概要：

### 1. 命令層級與構建工具
Debian軟體包的構建涉及多個命令工具，分為低級和高級工具：
- **低級工具**：
- `debian/rules`：專用腳本，管理軟體包構建過程。
- `dpkg-buildpackage`：核心構建工具。
- **高級工具**：
- `debuild`：集成`dpkg-buildpackage`和`lintian`，在乾淨環境中構建。
- `pbuilder`：Debian chroot環境核心工具。
- `pdebuild`：結合`pbuilder`和`dpkg-buildpackage`，在chroot環境中構建。
- `git-pbuilder`：命令行友好的`pdebuild`，由`gbp buildpackage`使用。
- `gbp`：在Git倉庫中管理Debian源碼。

高級工具（如`gbp buildpackage`和`pbuilder`）能夠提供完美的構建環境，但理解低級工具（如`debian/rules`和`dpkg-buildpackage`）的運行機制同樣重要。

---

### 2. 檢查軟體包中的錯誤
在上傳軟體包到公共倉庫前，需進行以下錯誤檢查：

#### 2.1 檔案冲突與安裝過程檢測
- 使用`debi`命令檢測安裝問題：

  $ sudo debi gentoo_0.9.12-1_i386.changes

- 通過下載Debian倉庫的`Contents-i386`檔案檢測檔案冲突：
- 如果檢測到衝突，可通过重新命名、分離公用檔案、使用`alternatives`機制或在`debian/control`中設置`Conflicts`來避免問題。

#### 2.2 Maintainer腳本檢測
- `preinst`、`prerm`、`postinst`和`postrm`等腳本難以手動編寫，新維護者建議使用`debhelper`自動生成。
- 測試內容包括：安裝、卸載、清除和升級。使用`dpkg`命令進行測試：

  $ sudo dpkg -r gentoo
  $ sudo dpkg -P gentoo
  $ sudo dpkg -i gentoo_version-revision_i386.deb

#### 2.3 软件包升級測試
- 測試流程：
1. 安裝前一個版本套件。
2. 升級套件。
3. 降級套件（可選）。
4. 徹底刪除套件。
5. 全新安裝套件。
6. 反安裝套件。
7. 再次安裝套件。
- 如果是首次建築套件，建議創建測試版本進行升級測試。

#### 2.4 使用工具檢測錯誤
- **`lintian`**：檢測`.changes`檔案的錯誤：

  $ lintian -i -I --show-overrides gentoo_0.9.12-1_i386.changes

- `E`：錯誤。
- `W`：警告。
- `I`：信息。
- `N`：註釋。
- `O`：已覆蓋。
- **`debdiff`**：比較兩個套件的內容：

  $ debdiff old-package.dsc new-package.dsc

- **`interdiff`**：檢查`diff.gz`檔案的改動：

  $ interdiff -z old-package.diff.gz new-package.diff.gz

- **`mc`**：查看`.deb`等檔案內容。
- **`dquilt`**：管理補丁檔案：

  $ dquilt push
  $ dquilt refresh

---

### 3. 其他注意事項
- 如果使用`sponsor`上傳軟體包，需清晰分離軟體包並記錄更改。
- 使用新工具時，建議避免單獨或預設目標，必要時使用`override_dh_*`進行調整。
- 相關文檔：
- [Debian 維護者指導](https://www.debian.org/doc/devel-manuals)。
- [Guide for Debian Maintainers](https://www.debian.org/doc/devel-manuals#debmake-doc)。

---

本文檔提供了Debian軟體包維護的核心工具和錯誤檢測方法，確保軟體包上傳前的質量和兼容性。新維護者建議參考最新的教程文件以獲取更多實用信息。