章 6. 構建套件

爲保證完整的軟件包(重)構建能順利進行，你必須保證系統中已經安裝

然後在原始碼目錄中執行以下命令：

$ dpkg-buildpackage -us -uc

這樣會自動完成所有從原始碼套件構建二進位套件的工作，包括：

如果構建結果令人滿意，那就用 debsign 命令以你的私有 GPG 金鑰簽署 .dsc 檔案和 .changes 檔案。你需要輸入密碼兩次。 ^[62]

對於非本土 Debian 軟件包，比如 gentoo， 構建軟件包之後，你將會在上一級目錄(~/gentoo) 中看到下列文件：

在上傳到 Debian FTP 倉庫中前，gentoo_0.9.12-1.dsc 檔案和 gentoo_0.9.12-1_i386.changes 檔案必須用 debsign 命令簽署，其中使用你自己存放在 ~/.gnupg/ 目錄中的 GPG 私鑰。 用你的公鑰，可以令 GPG 簽名證明這些檔案真的是你的。

debsign 命令可以用來以指定 ID 的 GPG 金鑰進行簽署 （這方便了贊助(sponsor)軟體包）， 只要照著下邊在 ~/.devscripts 中的內容：

DEBSIGN_KEYID=Your_GPG_keyID

.dsc 和 .changes 文件中很長的數字串是其中提及文件的 SHA1/SHA256 校驗和。下載你軟件包的人可以使用 sha1sum(1) 或 sha256sum(1) 來進行覈對。如果校驗和不符，則說明文件已被損壞或偷換。

Debian 支持非常多的 移植(port)，同時它有着 自動構建網絡，這個網絡在不同體繫結構的計算機上運行着 buildd 守護進程。 雖然你不需要自己做這件事情，你也應該知道在你的軟件包身上發生了什麼。讓我們來簡要地看看他們是如何爲你給多個體繫結構構建軟件包的。 ^[64]

對於 Architecture: any 的軟件包，自動編譯系統重構建它們。它確保系統中已經安裝

然後在原始碼目錄中執行以下命令：

$ dpkg-buildpackage -B

這樣會自動完成從原始碼套件構建平臺依賴二進位套件的工作，包括：

這就是你看到你的套件在其他平臺上可用的原因。

儘管通常的打包工作中 Build-Depends-indep 字段中列出的軟件包都需要安裝(參看 節 6.1, “完整的(重)構建”)，但是在編譯平臺依賴二進制包時它們無需在自動編譯系統上安裝。^[65]通常打包和自動編譯系統的這種不同爲你指出如何考慮必須的軟件包應如何放在 debian/control 文件的 Build-Depends 或 Build-Depends-indep 域中(參看 節 4.1, “control”)。

你可以使用 debuild 命令來進一步自動化 dpkg-buildpackage 的構建過程。參看 debuild(1)

debuild 命令會執行 lintian 命令，以在 Debian 軟體包構建結束之後進行靜態檢查。 lintian 命令可以用下邊出現在 ~/.devscripts 檔案中的項來定製：

DEBUILD_DPKG_BUILDPACKAGE_OPTS="-us -uc -I -i"
DEBUILD_LINTIAN_OPTS="-i -I --show-overrides"

在普通用戶帳號中可以使用以下這樣簡單的命令清理源代碼並重構建軟件包：

$ debuild

還可以這樣簡單地清理源代碼樹：

$ debuild -- clean

對於使用淨室(chroot)編譯環境來驗證編譯依賴而言，pbuilder 軟件包是非常有用的。^[66]它確保了軟件包在不同構架上的 sid 發行版環境中的自動編譯器中能乾淨地編譯，避免了總是被歸類於 RC (Release Critical，影響發佈)的嚴重 FTBFS (Fails To Build From Source，從源代碼編譯失敗) Bug。^[67]

我們通過以下操作來定製 pbuilder 軟件包。

首先使用以下命令初始化本地 pbuilder chroot 系統：

$ sudo pbuilder create

如果你已經創建了源代碼包，在包含 foo.orig.tar.gz、foo.debian.tar.gz 和 foo.dsc 文件的目錄中執行下面的命令來更新 pbuilder chroot 系統以便在其中執行構建：

$ sudo pbuilder --update
$ sudo pbuilder --build foo_version.dsc

新構建的無 GPG 簽名的軟件包會被以非 root 屬主放置於 /var/cache/pbuilder/result/。

.dsc 文件和 .changes 文件中的 GPG 簽名可以用如下方法生成：

$ cd /var/cache/pbuilder/result/
$ debsign foo_version_arch.changes

如果你已經更新了源代碼樹但沒有生成對應的源代碼包，在存放 debian 目錄的源碼目錄裏執行：

$ sudo pbuilder --update
$ pdebuild

你可以使用 pbuilder --login --save-after-login 命令登錄到這個 chroot 環境中並按照需要對其進行設定。通過 ^D (Control-D)離開這個 shell 時環境會被保存。

最新版的 lintian 命令可以通過設置鉤子腳本 /var/cache/pbuilder/hooks/B90lintian 在 chroot 環境中運行。腳本內容如下：^[68]

#!/bin/sh
set -e
install_packages() {
        apt-get -y --allow-downgrades install "$@"
        }
install_packages lintian
echo "+++ lintian output +++"
su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes" - pbuilder
# use this version if you don't want lintian to fail the build
#su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes; :" - pbuilder
echo "+++ end of lintian output +++"

爲 sid 編譯軟件包需要使用 sid 環境。在現實中 sid 存在很多問題以至於你不願意將整個系統都遷移到其上。pbuilder 軟件包可以在這種情況下很好地解決問題。

你可能需要在 stable 軟體包釋出後為 stable-proposed-updates、stable/updates 等倉庫升級你維護的軟體包。^[69]對於這類情況，“我正在執行 sid 系統”並不是你不為它們進行升級的充分理由。pbuilder 軟體包可以幫助你使用到相同 CPU 體系結構下幾乎所有 Debian 和 Debian 衍生版系統環境。

參見 http://www.netfort.gr.jp/~dancer/software/pbuilder.html, pdebuild(1), pbuilderrc(5), 和 pbuilder(8).

如果你的上游對源代碼使用版本控制系統(VCS)^[70]，你也應該考慮使用它們。這會使得合併和提取上游補丁更加簡單。有多個爲不同 VCS 設計的包裝腳本包來協助 Debian 軟件包構建。

git-buildpackage 的使用 在 Debian 開發者之中非常流行， 它可以使用 alioth.debian.org 上的 Git 服務器來管理 Debian 軟件包。 ^[71] 這個軟件包提供了許多命令來 自動化 打包操作：

這些命令使用 3 個分支來跟蹤打包操作：

你可以設置 git-buildpackage，通過修改 ~/.gbp.conf 文件。參見 gbp.conf(5). ^[73]

對於很大的軟件包，在調試 debian/rules 的過程中你可能不想每次都對整個軟件包進行重構建。僅用於測試目的，你可以不重新構建源代碼包而使用以下的方法創建 .deb 文件^[74]：

$ fakeroot debian/rules binary

或者可以通過以下方法驗證它是否能通過編譯：

$ fakeroot debian/rules build

一旦完成了調試，記住要按照前面所將的正常過程重構建你的套件。你可能無法正常上傳用此種方法構建的 .deb 檔案。

這裏有一個簡練的總結，關於在命令層次結構中有多少用於構建軟件包的命令能夠組合到一起。做這件事情的方法非常多。

• debian/rules = 軟件包構建過程的專用 maintainer script

• dpkg-buildpackage = 軟件包構建之核心工具

• debuild = dpkg-buildpackage + lintian (在乾淨的環境變量下構建)

• pbuilder = Debian chroot 環境核心工具

• pdebuild = pbuilder + dpkg-buildpackage (在chroot環境中構建)

• cowbuilder = 加速 pbuilder 執行

• git-pbuilder = 命令行語法友好pdebuild (被 gbp buildpackage 使用)

• gbp = 在 Git 倉庫中管理 Debian 源碼

• gbp buildpackage = pbuilder + dpkg-buildpackage + gbp

即便像 gbp buildpackage 和 pbuilder 這樣的高級命令的應用可以確保完美的軟件包 構建環境，瞭解像 debian/rules 和 dpkg-buildpackage 這樣的低級命令行工具如何被它們執行也是至關重要的。