Debian 新維護人員手冊

《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`命令檢測安裝問題： ```bash $ 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`命令進行測試： ```bash $ 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`檔案的錯誤： ```bash $ lintian -i -I --show-overrides gentoo_0.9.12-1_i386.changes ``` - `E`：錯誤。 - `W`：警告。 - `I`：信息。 - `N`：註釋。 - `O`：已覆蓋。 - **`debdiff`**：比較兩個套件的內容： ```bash $ debdiff old-package.dsc new-package.dsc ``` - **`interdiff`**：檢查`diff.gz`檔案的改動： ```bash $ interdiff -z old-package.diff.gz new-package.diff.gz ``` - **`mc`**：查看`.deb`等檔案內容。 - **`dquilt`**：管理補丁檔案： ```bash $ 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軟體包維護的核心工具和錯誤檢測方法，確保軟體包上傳前的質量和兼容性。新維護者建議參考最新的教程文件以獲取更多實用信息。