- git fork
- 修改patch（可选）
- build dsc file
- dch -i
- Build a source package .dsc
- Build the binary packages with Pbuilder
- error 及应对
- 参考命令
- symbols file
根据Debian社区大佬的要求，如果想成为一个package maintainer的话，仅仅修改这个field是不够的，还必须有其他的改动。 一开始还确实不太理解，觉得对方是在双标，然而等自己真正实践起来才发现，大佬的想法没错。如果连最基本的都操作不了，如果出了问题怎么解决？
丢人也好，受气也罢，最关键的一点是，是自己太菜。目前的工作完全支持我在这一块全身心的投入，还有什么理由做不好呢？
为什么说Debian社区比较geek呢(其他发行版我用的也不多)，就是debian自己的工具，什么都能给你造一个出来，这不，社区给你打早了一个封装git的命令 gbp,对，应该就是 git-buildpackage的缩写。
最权威的参考手册莫过于这里. 这里有个中文的文章也是非常的精彩。
首先介绍下目前git-buildpackage的一些workflow。
- debian-branch : 也就是自己维护工作的分支,针对于debian而言（目前默认是debian/main）；
- upstream-branch ： 这个是用来保持upstream的记录的，默认是 upstream/latest
- pristine-tar branch: 初始化时， gbp会默认创建这个分支。
git fork
Debian开发人员为了自己管理代码与upstream方便的进行交互，一般来说会在 salsa.debian.org创建一个repo。这个repo与upstream的区别就是，摒除git的概念，只从代码的角度来看，就是在salsa repo中添加了一个 debian的名录。看到这里，你应该就明白这是怎么一回事了吧。
我首先 forked https://salsa.debian.org/debian/jimtcl到自己名下https://salsa.debian.org/vimerbf-guest/jimtcl.其实，这里也就是说明了一件事，如果salsa上面已经存在一个你想维护的包，可以直接fork下来使用。
下面的操作参考这里
我们看一下fork出来的branch情况:
vimer@debian-local:~/git/jimtcl/jimtcl$ git branch -a
* debian/main
remotes/origin/HEAD -> origin/debian/main
remotes/origin/debian/experimental
remotes/origin/debian/main
remotes/origin/pristine-tar
remotes/origin/upstream/latest
remotes/origin/upstream/latest-repack
我们看到，除了本地有一个debian/main, upstream/latest分支没有本地分支，pristine-tar我们暂时不用管，gbp会自己创建。 那么，我们得首先创建 upstream/latest 分支(这一块我也不是特别明白，如果有误解，请指正)。
vimer@debian-local:~/git/jimtcl/jimtcl$ git branch upstream origin/upstream/latest
分支 'upstream' 设置为跟踪来自 'origin' 的远程分支 'upstream/latest'。
vimer@debian-local:~/git/jimtcl/jimtcl$ git branch pristine-tar origin/pristine-tar
分支 'pristine-tar' 设置为跟踪来自 'origin' 的远程分支 'pristine-tar'。
然后upstream，可以使用指定。
gbp import-orig https://github.com/msteveb/jimtcl/archive/refs/tags/0.81.tar.gz
如果这个时候报这个错误，可以使用下面的方式:
vimer@debian-local:~/git/jimtcl/jimtcl$ gbp import-orig https://github.com/msteveb/jimtcl/archive/refs/tags/0.81.tar.gz
gbp:error:
Repository does not have branch 'upstream/latest' for upstream sources. If there is none see
file:///usr/share/doc/git-buildpackage/manual-html/gbp.import.html#GBP.IMPORT.CONVERT
on howto create it otherwise use --upstream-branch to specify it.
如果github抽风，还可以使用--pristine-tar指定tar文件:
$ gbp import-orig --pristine-tar ../0.81.tar.gz --debian-branch=debian/main -u 0.81 gbp:info: Importing '../0.81.tar.gz' to branch 'upstream/latest'...
gbp:info: Source package is jimtcl
gbp:info: Upstream version is 0.81
Branch 'pristine-tar' set up to track remote branch 'pristine-tar' from 'origin'.
gbp:info: Replacing upstream source on 'debian/main'
gbp:info: Successfully imported version 0.81 of ../jimtcl_0.81.orig.tar.gz
其中， --debian-branch就是我们的本地分支， -u指定版本。
或者：
gbp import-orig https://github.com/msteveb/jimtcl/archive/refs/tags/0.81.tar.gz --debian-branch=debian/main --upstream-branch=upstream -u 0.81
现在我们可以看下branch的情况:
vimer@debian-local:~/git/jimtcl/jimtcl$ git branch -a
* debian/main
pristine-tar
upstream/latest
remotes/origin/HEAD -> origin/debian/main
remotes/origin/debian/experimental
remotes/origin/debian/main
remotes/origin/pristine-tar
remotes/origin/upstream/latest
remotes/origin/upstream/latest-repack
接着看一下 git log:
commit 0d9289c68cca547ee4815b0d9ea2e0aaab57a7e0 (HEAD -> debian/main)
Merge: b8edd3d 8e5bb80
Author: vimer <[email protected]>
Date: Wed Mar 9 11:29:43 2022 +0800
Update upstream source from tag 'upstream/0.81'
Update to upstream version '0.81'
with Debian dir 49f71ac6d713ed89146f5f7525bad4ba5855b69f
commit 8e5bb802b183ce511f70dc9978d4a1bb797b4cf7 (tag: upstream/0.81, upstream/latest)
Author: vimer <[email protected]>
Date: Wed Mar 9 11:29:30 2022 +0800
New upstream version 0.81
commit b8edd3d0e96e36089dcf78be01702692c0f92f43 (tag: debian/0.79+dfsg0-3, origin/debian/main, origin/HEAD)
Author: Didier Raboud <[email protected]>
Date: Fri Sep 3 16:22:09 2021 +0200
jimtcl 0.79+dfsg0-3 Debian release
修改patch（可选）
假设有的话。
# 1. 先处理debian/patches/下的文件
gbp pq import
# 2.
gbp pq export
# 3. commit
git add xx && git commit --amend
build dsc file
gbp buildpackage --git-debian-branch=debian/main --git-export-dir=/tmp/build-area/jimtcl -S
因为有很多用法没有搞明白，导致出现了很多的error。下面这个是我试验OK的。
gbp buildpackage --git-debian-branch=debian/main --git-upstream-tree=upstream --git-pristine-tar-commit --git-export-dir=/tmp/build-area/jimtcl -S --git-verbose
--git-debian-branch=debian/main 指明debian branch。
--git-upstream-tree=upstream也很关键： How to find the upstream sources used to generate the tarball，因为我是使用的pristine来引入upstream的源码，如果是其他的，估计不会使用这个选项了。请参考这里，主要是，我这里没有把标签打上去。
--git-pristine-tar-commit: Commit the pristine-tar delta to the pristine-tar branch if a new tarball was generated and the pristine-tar data isn’t already there. 这段话的意思其实我是拿捏不准的。
--git-export-dir=/tmp/build-area/jimtcl -S是把该tarball的dsc文件放在这个位置，方便后面的build。
--git-verbose是可以详细的把执行过程打印出来，方便debug使用。
dch -i
如果已经有了 debian目录，我们可以暂时不必使用(debmake)命令去自动生成debian目录下的东西；如果没有的话，需要执行。
如果已经有了debian目录，我们的工作就是查漏补缺。第一步就是更新版本号，这里注意一下:
vimer@debian-local:~/git/jimtcl/jimtcl-0.81$ dch -i
dch warning: neither DEBEMAIL nor EMAIL environment variable is set
dch warning: building email address from username and mailname
dch: Did you see those 2 warnings? Press RETURN to continue...
然后使用dch -i去更改changelog文件。有几个地方需要改一下：
unknown 要改成 unstable(或者experimential),bug number 要改為自己的 ITP number,修改自己的名字與 email.
`debmake只会生成模板，实质性的内容并不会起作用。
Build a source package .dsc
这里的dsc就是debian source control文件，可以参考这里
gbp buildpackage --git-export-dir=/var/tmp/build-area/packagename -S
Build the binary packages with Pbuilder
pbuilder build --basetgz /var/cache/pbuilder/lucid.tgz /var/tmp/build-area/packagename/packagename_version.dsc
error 及应对
gbp import-orig https://github.com/msteveb/jimtcl/archive/refs/tags/0.81.tar.gz
gbp:error:
Repository does not have branch 'upstream/latest' for upstream sources. If there is none see
file:///usr/share/doc/git-buildpackage/manual-html/gbp.import.html#GBP.IMPORT.CONVERT
on howto create it otherwise use --upstream-branch to specify it.
# 需要 checkout -b 一个
vimer@debian-local:~/git/jimtcl/jimtcl$ git checkout -b upstream/latest
切换到一个新分支 'upstream/latest'
vimer@debian-local:~/git/jimtcl/jimtcl$ gbp import-orig https://github.com/msteveb/jimtcl/archive/refs/tags/0.81.tar.gz
What is the upstream version? [] 0.81
gbp:info: Importing '../0.81.tar.gz' to branch 'upstream/latest'...
gbp:info: Source package is jimtcl
gbp:info: Upstream version is 0.81
Branch 'pristine-tar' set up to track remote branch 'pristine-tar' from 'origin'.
gbp:info: Merging to 'debian/master'
gbp:error: Import of ../jimtcl_0.81.orig.tar.gz failed: Error running git checkout: error: 路径规格 'debian/master' 未匹配任何 git 已知文件
gbp:error: Error detected, Will roll back changes.
gbp:info: Rolling back branch upstream/latest by resetting it to a86b79ef1858b0ab651302dd1f4bcf9190bfdf73
gbp:info: Rolling back branch 'pristine-tar' by deleting it
gbp:info: Rolling back tag 'upstream/0.81' by deleting it
gbp:info: Rolling back branch 'debian/master' by deleting it
gbp:error: Rolled back changes after import error.
你看，上面又报了这个错，我们接着拆招吧~
vimer@debian-local:~/git/jimtcl/jimtcl$ git checkout -b debian/master
切换到一个新分支 'debian/master'
vimer@debian-local:~/git/jimtcl/jimtcl$ gbp import-orig https://github.com/msteveb/jimtcl/archive/refs/tags/0.81.tar.gz --debian-branch=debian/master -u 0.81
gbp:error: Failed to download https://github.com/msteveb/jimtcl/archive/refs/tags/0.81.tar.gz: ../0.81.tar.gz already exists
vimer@debian-local:~/git/jimtcl/jimtcl$ gbp import-orig --pristine-tar ../0.81.tar.gz --debian-branch=debian/master -u 0.81 gbp:info: Importing '../0.81.tar.gz' to branch 'upstream/latest'...
gbp:info: Source package is jimtcl
gbp:info: Upstream version is 0.81
Branch 'pristine-tar' set up to track remote branch 'pristine-tar' from 'origin'.
gbp:info: Replacing upstream source on 'debian/master'
gbp:info: Successfully imported version 0.81 of ../jimtcl_0.81.orig.tar.gz
参考命令
这些参考命令放在这里，逐渐加深印象。
# 1
gbp buildpackage --git-ignore-new --git-no-pristine-tar --verbose
#2
gbp config buildpackage
简单的命令
假设co-team上传了一个远程分支，你可以更简单的使用:
git checkout master-16.x
gbp buildpackage --git-pbuilder --git-ignore-new -sa # 补充完全
直接使用git
也就是没有tarball的情况下怎么办?
sudo gbp buildpackage --git-submodules --git-no-pristine-tar --git-upstream-tree=tag --git-ignore-new -sa --git-export-dir=../
但是这个也会有问题，需要第一次把 -u说明正确。
symbols file
原来是旧的 0.79.symbols, 现在是新的0.81.symbols
sudo dpkg-deb -x libjim0.81_0.81+dfsg0-1_amd64.deb /tmp/jimctl # 解包
sudo dpkg-gensymbols -v0.81 -plibjim -P/tmp/jimctl/ -Olibjim.symbols # 得到符号表
https://wiki.debian.org/UsingSymbolsFiles