1

sudo apt update -q && sudo apt install -q --yes sbuild mmdebstrap uidmap piuparts git-buildpackage dpkg-dev dh-make  apt-cacher-ng

1
2

mkdir -p ~/.cache/sbuild
mmdebstrap --skip=output/dev --variant=buildd --include=eatmydata unstable ~/.cache/sbuild/unstable-amd64.tar.zst http://ftp.cn.debian.org/debian --aptopt='Acquire::http { Proxy "http://127.0.0.1:3142"; }'

1
2
3
4

gbp clone vcs-git:some-project --add-upstream-vcs
# 或者，运行此程序来定义一个需要跟踪的上游分支：
gbp clone vcs-git:some-project \
    --postclone="git remote add -t develop -f upstreamvcs https://github.com/eradman/entr.git"

1
2
3

git init --initial-branch="$(gbp config DEFAULT.debian-branch)" some-project.git
cd some-project.git
gbp import-orig https://some-project.example.com/releases/some-project_1.0.tar.gz

1
2
3
4
5
6
7

# Clone the upstream repository and `cd` into it:
git clone https://forge.example.com/some-project.git
cd project.git

# Use DEP-14 branch names
git branch -m upstream/latest
git checkout -b debian/latest

1
2
3
4

# Set branch name when creating the repo:
git init --initial-branch="$(gbp config DEFAULT.upstream-branch)" some-project
# Or rename the branch when you start to Debianise:
git branch -m master "$(gbp config DEFAULT.upstream-branch)"

1
2

git checkout -b "$(gbp config DEFAULT.debian-branch)" \
    --track "$(gbp config DEFAULT.upstream-branch)"

1

dh_make -c gpl3 -p some-project_version --createorig -sy

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# 1. 进入/重置补丁队列
gbp pq import --force

# --- 在这里进行你的修改、Cherry-pick 等操作 ---
# git add .
# git commit -m "fix something"

# 2. 导出补丁并自动提交到主分支
# --drop 保证主分支干净，--commit 自动 add debian/patches
gbp pq export --drop --commit

# 3. 润色提交信息 (可选)
# 这一步会打开编辑器，让你把 "Update patches" 改成更有意义的信息
git commit --amend

# 4. 正式构建
# 此时你已经回到了 debian/latest 分支，gbp 能找到所有需要的 treeish
gbp buildpackage

1
2
3
4
5
6
7
8
9

# 1. 根据上一个 tag 至今的所有 commit 自动生成临时 changelog
gbp dch --auto --snapshot

# 2. 如果准备发布新版本（例如 5.7-1）
# 这会移除 "snapshot" 标记，更新版本号，并标记为已释放（unreleased -> unstable）
gbp dch --auto --release --new-version=5.7-1

# 3. 检查并手动润色（如有必要）
git commit -m "Update changelog for 5.7-1" debian/changelog

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 确保在 debian/latest 分支上
git checkout debian/latest

# 拉取上游最新代码
git fetch origin upstream/latest

# 在上游最新提交上打上游版本 tag（需 GPG 签名）
git tag -s upstream/0.1.2 upstream/latest -m "Upstream release 0.1.2"

# 验证 tag
git tag -v upstream/0.1.2

1
2
3
4

# 将上游最新代码合入 debian/latest
git merge upstream/latest --no-edit

# 如果有冲突，手动解决后 git commit

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 导入补丁队列（切换到 patch-queue 分支）
gbp pq import --force

# 在 patch-queue 分支上进行修改
# 例如：更新 pyproject.toml 中的版本号
sed -i 's/version = "0.1.0"/version = "0.1.2"/' pyproject.toml
git add pyproject.toml
git commit -m "Update upstream version to 0.1.2"

# 导出补丁并切回 debian/latest，自动提交补丁文件
gbp pq export --drop --commit

1
2
3
4
5
6
7

# 根据自上一个 tag 以来的 commit 自动生成 changelog
gbp dch --auto --release --new-version=0.1.2-1
# 注意：如果 spawn-editor = always 导致 EDITOR 阻塞，可用 EDITOR=true 前置

# 提交 changelog
git add debian/changelog
git commit -m "Update changelog for 0.1.2-1"

1
2
3
4
5
6
7
8
9

# 确保 debian/source/options 排除本地开发文件
# 以下为示例 extend-diff-ignore 配置：
# extend-diff-ignore = "^[^/]*[.]egg-info/|^.venv/|^.claude/|^.pdm-python$|^pdm.lock$"

# 确保 .gitignore 包含虚拟环境和构建产物
# .venv/、.pc/、dist/ 等

# 删除本地虚拟环境和构建缓存
rm -rf .venv .pybuild/ dist/

1
2

# 执行构建（--git-ignore-new 忽略补丁造成的未提交变更）
gbp buildpackage --git-ignore-new