通用命令：

apt-get -y install --no-install-recommends -t buster-backports git git-buildpackage \
  dpkg-dev debhelper dh-make dh-runit devscripts dh-autoreconf quilt lintian lintian-brush \
  dh-exec dgit dupload debmake dh-make-perl pristine-tar debconf-utils debsums \
  build-essential:native dh-python libdistro-info-perl strace vim-scripts blhc reprotest \
  appstream-util apt-file libncurses-dev bison flex libssl-dev pkg-kde-tools reportbug licensecheck

在 Debian 11 下：

apt-get -y install --no-install-recommends -t bullseye-backports git git-buildpackage \
  dpkg-dev debhelper dh-make dh-runit devscripts dh-autoreconf quilt lintian dh-exec dgit \
  dupload debmake pristine-tar debconf-utils debsums build-essential:native dh-python \
  libdistro-info-perl strace vim-scripts ubuntu-dev-tools blhc reprotest appstream-util \
  apt-file libncurses-dev bison flex libssl-dev pkg-kde-tools reportbug cmake licensecheck \
  libgit-wrapper-perl libstring-shellquote-perl atzlinux-deb-template tools-atzlinux-dev \
  libclass-inspector-perl wlc

在 Debian 12 下：

apt-get -y install --no-install-recommends -t bookworm-backports git git-buildpackage \
  dpkg-dev debhelper dh-make dh-runit devscripts dh-autoreconf quilt lintian dh-exec dgit \
  dupload debmake pristine-tar debconf-utils debsums build-essential:native dh-python \
  libdistro-info-perl strace vim-scripts ubuntu-dev-tools blhc reprotest appstream-util \
  apt-file libncurses-dev bison flex libssl-dev pkg-kde-tools reportbug cmake licensecheck \
  libgit-wrapper-perl libstring-shellquote-perl atzlinux-deb-template tools-atzlinux-dev \
  tools-atzlinux tools-atzlinux-dev-conf libclass-inspector-perl wlc libsoap-lite-perl routine-update

软件包制作推荐参考以下文档：

• 《Debian 新维护者手册》
• 《Debian 维护者指南》
• 《Debian Policy Manual》
• 《Debian Developer's Reference》

以上 4 个文档均可在本地安装相应软件包阅读：

apt -y install maint-guide-zh-cn debmake-doc debian-policy developers-reference

gbp 命令文档已随 git-buildpackage 软件包安装，路径为：

file:///usr/share/doc/git-buildpackage/manual-html/index.html

软件包在本地制作成功后，请用 lintian 命令检查 deb 包是否有各类问题。lintian 检查通过后， 请通知开发者进行进一步的测试验证，线下联系、邮件或者微信均可。

开发者将会在码云新建软件仓库并授予该仓库相关权限。从其它软件包仓库拷贝 debian 目录、 参照修改后，如果没有问题就会上传到 apt 软件源。

apt -y install lintian/bullseye-backports

如果现有的中文桌面应用开源项目目前还没有 deb 包，也欢迎联系制作打包。在现有项目下增加一个 debian 目录，即可实现打包。

也可以把现有项目作为仓库上游，在铜豌豆码云仓库 Fork 一份，铜豌豆的仓库增加 debian 目录专门处理打包相关代码， 上游有新版本 merge 移植过来即可。

第三方软件包

从其它发行版或者第三方直接收录的 deb 软件包。尽量不修改软件包文件名，对不符合 Debian 规范的部分可以最小限度地修改， 如将文件名改成以 _amd64.deb 结尾。

建议使用 dpkg-name 命令进行规范化改名。对于文件名中含有 latest 字符串来表示版本号的，可以将最新版本使用该名称， 历史版本恢复其版本号。

该类软件包不需要在 https://gitee.com/atzlinux/projects 创建 git 仓库。

铜豌豆制作软件包

软件项目原来没有 deb 格式的软件包，或者原有 deb 包需要做修改、重新打包后才可以在铜豌豆上使用的软件包。

在原有版本号后面加上后缀，规则如下：

• ~日期atzlinux：英文波浪号 + 8 位年月日数字（中间不包含点或中划线）+ atzlinux 字符串。适合 Debian 官方软件包有 NMU 上传的情况。
• .日期atzlinux：英文句号 + 8 位年月日数字 + atzlinux 字符串。适合 Debian 官方软件包没有 NMU 上传的情况。
• -日期atzlinux：英文中划线 + 8 位年月日数字 + atzlinux 字符串。适合第三方软件包、铜豌豆率先制作的情况。

如果同一天有发布多个版本，可以在 atzlinux 后面加数字。

debian/source/format 文件内容为 3.0 (quilt)，生成的源代码压缩包文件有两个：一个包含 orig 字样、以 orig.tar.xz 结尾， 另一个以 .debian.tar.xz 结尾。该类软件包需要在 https://gitee.com/atzlinux/projects 创建 git 仓库。

铜豌豆原生软件包

由铜豌豆项目自身新制作的软件包。

软件包名需要在最前面或者最后面有 atzlinux 字符串，和其它字符串中间用英文中划线 - 隔开；源代码包的包名可以不包含 atzlinux 字符串。

版本号从 1.0.0 开始（部分老软件是带点的日期）。因此类软件包的包名中已经有 atzlinux 字符串，所以版本号中不需要再包含。

debian/source/format 文件内容为 3.0 (native)，生成的源代码压缩包文件只有一个，不含 orig 字样， 也没有以 .debian.tar.xz 结尾的压缩文件。

该类软件包需要在 https://gitee.com/organizations/atzlinux/projects 创建 git 仓库。打包制作过程中的问题可以在铜豌豆开发者群里面讨论。

Debian 官方软件包

由铜豌豆项目成员维护的 Debian 官方软件包，命名优先使用 Debian 官方规则，软件包名称或者版本号可以酌情带上 atz、atzlinux 字符串。

该类软件包不需要在 https://gitee.com/atzlinux/projects 创建 git 仓库，继续使用 Debian 的 salsa git 仓库即可。

对于铜豌豆软件源使用的 Debian 官方软件包有少量差异、需要重新打包的情况，在现有 salsa git 仓库里面创建 atzlinux/latest 分支进行维护。

可以在用户目录的 .bashrc 文件里面增加 deb 包制作相关环境变量：

DEBEMAIL="username@atzlinux.com"
DEBFULLNAME="姓名"
DEB_SIGN_KEYID="gpg id"
export DEBEMAIL DEBFULLNAME DEB_SIGN_KEYID

git、gpg 签名、debian/changelog 等地方需要用到的姓名、email 地址，请尽可能保持一致。

其它推荐设置：

export EDITOR="vim"        # 设置 vi 默认使用 vi 增强版 vim 打开
export GPG_TTY=$(tty)      # 设置 gpg 终端，否则无法使用 git 签名提交等功能

因 devscripts 里给包签名的命令 debsign 不支持环境变量，需要在 /etc/devscripts.conf 或用户目录 ~/.devscripts 里设置：

DEBSIGN_ALWAYS_RESIGN=yes
DEBSIGN_KEYID="BB97304EFD6634C7D4D36AB62F338C7DC7909957"

/etc/git-buildpackage/gbp.conf 的默认设置不会在打包前清理上次编译遗留的中间文件，导致 gbp buildpackage 报错。 在该配置文件里加上如下设置，让打包命令每次自动执行清理：

cleaner = fakeroot debian/rules clean

lintian 的默认配置输出不详细，可以这样获得更详细的检查结果。

在用户目录 .bashrc 里增加别名：

alias lintian="lintian -I --pedantic -E"

或者在用户目录下增加 lintian 配置文件 .lintianrc（推荐使用该方式）：

display-info = yes
display-experimental = yes
pedantic = yes

在打包完成后的源代码目录下可以直接运行 lintian 检查打包情况。lintian-explain-tags 命令可以显示 lintian 报错信息标签的详细描述。

vim 编辑器安装 debPlugin 插件后，可以直接打开查看 deb 软件包里面的内容。

apt install vim-scripts

• Debian 10：apt install vim-addon-manager 安装插件管理软件包，vim-addons install debPlugin 在当前用户下安装插件， vim-addons -w install debPlugin 在整个系统安装插件。
• Debian 11：手工修改用户目录下的 .vimrc 文件，添加 packadd! debPlugin。

同时兼容 Debian 10 和 Debian 11 的写法：

if version >= "802"
    packadd! debPlugin
endif

• Debian 衍生版指引
• Debian 开发介绍中文 pdf 文件
• Debian 所有源代码搜索
• DEP - Debian Enhancement Proposals：其中 DEP: 14 有 git 分支命名、tag 标签命名等 git 仓库使用方面的提议
• Debian 术语表