桌面应用CLI【免费下载链接】bleachbitBleachBit system cleaner for Windows and Linux项目地址https://gitcode.com/gh_mirrors/bl/bleachbit点击查看免费下载本篇技术指南聚焦 BleachBit 仓库中 debian/README.md 所描述的打包工作流如何借助 Open Build ServiceOBS与osc命令行工具为 Debian/Ubuntu以及其他发行版构建 BleachBit 二进制包。读完本文你将掌握从安装osc、检出 OBS 打包文件、执行本地构建、分支测试包到查看构建状态与构建日志的完整操作链路同时理解debian/目录下各打包元数据文件control、rules、dsc、compat在构建中的实际作用并了解仓库内可复用的本地替代构建方案。一、debian/ 目录在 BleachBit 打包体系中的角色BleachBit 的源码仓库将打包相关文件按目标平台分散组织debian/目录专门存放Debian/Ubuntu 系打包文件其定位正如 debian/README.md 开头所述——本目录镜像了用于通过 Open Build ServiceOBS构建各种 BleachBit 包的文件。该目录下包含 6 个文件各自职责如下文件作用debian/bleachbit.dscDebian 源码控制文件Source Control File声明源码包格式Format 1.0、二进制包名、版本号当前为6.0.5-0以及源码压缩包与补丁的校验和debian/debian.control包的元数据主文件声明Source/Package、构建依赖Build-Depends、运行时依赖Depends与推荐依赖Recommendsdebian/debian.rulesdebhelper 构建规则文件#!/usr/bin/make -f定义build、clean、install、binary-indep等目标的执行细节debian/compat声明 debhelper 兼容级别内容为9debian/debian.changelogDebian 变更日志当前记录bleachbit (6.0.5) stable的升级条目debian/copyright版权与许可证声明GNU GPL v3或后续版本Copyright (C) 2008-2025 Andrew Ziem值得注意的是various多种在这里是准确的OBS 不只构建 Debian 包仓库根目录下的 bleachbit.spec 同样明确写着 This rpmbuild.spec is designed for the OpenSUSE Build Service to build packages for CentOS, Fedora, and OpenSUSE说明同一套 OBS 基础设施同时服务于 RPM 系与 DEB 系发行版。而debian/目录只负责 DEB 系这一侧。二、准备工作安装 osc 并注册 OBS 账号进入 OBS 工作流的第一步是安装客户端工具osc。osc是 OBS 官方提供的命令行客户端负责与 OBS 服务器交互——检出checkout打包文件、向服务器提交文件、触发远程构建、查询构建状态等。它是整个 OBS 打包流程的操作核心。安装osc后需要在 build.opensuse.org 上创建账号。原文档特别提示登录是必需的这是osc工具实际使用时的硬性前置条件OBS 不允许匿名使用客户端与服务器交互。完成安装与注册后就可以理解osc的核心定位了osc命令用于检出checkout文件并发送commit到 OBS 服务器而服务器会在收到新提交时自动启动构建。也就是说推送源码后无需手动触发OBS 的构建即会随之开始——自动构建是这套工作流的关键特性。三、从 OBS 检出打包文件并与仓库目录比对日常维护中最常见的起点是把 OBS 服务器上当前用于构建的文件取回本地与本仓库的debian/目录逐一比对确认服务器上运行的是否就是仓库里的最新版本。命令如下osc checkout home:andrew_z bleachbit -o /tmp/obsfiles diff -u3 /tmp/obsfiles .这里home:andrew_z是 OBS 上的项目名OBS 中个人/组织项目通常以home:用户名形式命名bleachbit是包名。-o /tmp/obsfiles指定检出文件落盘到本地临时目录随后diff -u3以统一格式unified format3 行上下文将检出结果与当前工作目录逐文件对比输出差异一目了然。原文档同时给出了该命令的通用语法速记osc co project package --outdir pathosc co是osc checkout的短别名二者等价--outdir对应示例中的-o参数用于指定输出目录。执行检出后本地得到的是一份完整的、可在 OBS 上直接构建的源码包树而不是仅仅一个bleachbit.dsc。四、本地构建在推送前先用 osc build 验证在把修改推送到 OBS 之前建议先做一次本地构建验证。做法是在osc检出得到的目录中执行osc build xUbuntu_20.10其中xUbuntu_20.10是项目仓库配置中的一个自定义名称。OBS 的 Debian/Ubuntu 仓库遵循形如x发行版_版本号的命名惯例例如xUbuntu_20.10、xUbuntu_20.04、xUbuntu_18.04但原文档特别强调这个名称本质上是项目里已配置仓库的自定义名字它必须存在于你所检出的 OBS 项目仓库配置中否则无法解析出构建环境。osc build会在本地依照 OBS 项目的仓库配置搭建一个隔离的构建环境chroot 或虚拟机执行一次真实的完整构建。这样做的好处是任何依赖缺失、打包脚本错误、文件路径问题都能在提交到 OBS 之前暴露避免污染服务器上的构建队列。五、分支 OBS 包隔离测试构建的标准做法当你需要试验性修改、但又不想直接影响 OBS 上的正式包时可以用osc branch为包创建分支fork。原文档给出了完整操作示例$ osc branch home:andrew_z bleachbit A working copy of the branched package can be checked out with: osc co home:abitrolly:branches:home:andrew_z/bleachbitosc branch会在当前用户示例中为abitrolly名下创建原包的一个分支副本项目路径自动变为home:abitrolly:branches:home:andrew_z。随后用返回的osc co命令即可把分支副本检出到本地进行修改、构建测试确认无误后再通过osc submitrequest之类的流程把改动合并回原包。这套先分支、后合入的流程与 Git 的分支开发思路同构保证了正式包的稳定性。六、查看构建状态与构建日志osc results 与 osc buildlog每次提交后OBS 会在配置的所有仓库repo× 架构arch组合上分别构建。查看全局状态用osc results$ osc results xUbuntu_20.10 x86_64 failed xUbuntu_20.04 x86_64 succeeded* xUbuntu_18.04 x86_64 succeeded* ...输出以仓库名 架构 构建结果为一行的表格形式呈现例如xUbuntu_20.10在x86_64上构建失败而xUbuntu_20.04、xUbuntu_18.04均成功。逐仓库逐架构的状态一目了然便于快速定位失败面。当某个仓库构建失败时需要深入查看日志定位原因使用osc buildlog注意原文档示例中的osc buildlod是osc buildlog的笔误实际命令为osc buildlog$ osc buildlog xUbuntu_20.10 ... [ 97s] [ 83.277694] reboot: Power down [ 97s] ### VM INTERACTION END ### [ 97s] [ 97s] cloud132 failed build bleachbit.dsc at Sat Nov 28 17:44:06 UTC 2020. [ 97s]这段日志末尾揭示了失败的关键信息构建在虚拟机VM中执行结束时输出reboot: Power down与### VM INTERACTION END ###标记虚拟机交互阶段结束最后一行cloud132 failed build bleachbit.dsc表明失败发生在build bleachbit.dsc 这一构建阶段即 OBS 依据 debian/bleachbit.dsc 文件装配 Debian 源码包的过程并记录了失败时间。把哪个阶段失败 哪个仓库失败 什么时候失败三者对齐排查效率会显著提升。osc buildlog完整输出会显示具体到命令行的完整日志配合osc results使用即可闭环完成失败定位。七、从 debian/ 打包元数据看 OBS 实际构建的输入osc build在 OBS 上触发后真正决定怎么构建的是debian/目录下的元数据。理解它们才能理解 OBS 构建的本质。7.1 debian.control声明依赖关系debian/debian.control 是 OBS 解析依赖的入口。其关键字段包括Source: bleachbit、Section: admin、Priority: optional源码包名与分类Maintainer维护者 Andrew ZiemBuild-Depends: debhelper ( 4.1.16), python3, desktop-file-utils构建期依赖——debhelper 提供 dh_* 构建辅助工具python3 提供解释器desktop-file-utils 提供desktop-file-install/desktop-file-validate等桌面文件工具Architecture: all纯 Python 应用二进制包与架构无关这也与 setup.py 中声明的平台信息Python v3.8、GTK v3.24一致Depends运行时依赖包括gir1.2-gtk-3.0、gir1.2-notify-0.7、libgtk-3-0GTK3 图形栈、python3、python3-giGObject 绑定、python3-psutil、python3-requestsRecommends: pkexec | policykit-1, python3-notify推荐依赖其中pkexec/policykit-1与以管理员身份运行功能相关——仓库中的 org.bleachbit.policy 定义了org.bleachbit的 PolicyKit 动作要求管理员认证auth_admin并指定可执行路径/usr/bin/bleachbit。这些字段在 OBS 构建环境中会被转换为实际的包管理操作apt-get build-dep等缺失任一构建依赖都会导致构建环境装配失败。7.2 debian.rules Makefile构建三步曲debian/debian.rules 是 debhelper 风格的规则文件其build、install、binary-indep目标与仓库根目录 Makefile 的目标协作完成打包。从源码可以还原出三条关键逻辑生成管理员模式桌面入口build目标先复制org.bleachbit.BleachBit.desktop为org.bleachbit.BleachBit-root.desktop再用sed将名称改为 BleachBit as Administrator、将启动命令改为Execpkexec bleachbit见 debian/debian.rules。这样安装后桌面会出现一个经由 PolicyKit 提权启动的入口。bleachbit.spec中对 RPM 系采用同样的处理思路openSUSE 用xdg-suRed Hat 系用pkexec。剔除 Windows 专属内容build目标调用make delete_windows_filesOBS 构建的是 Linux 包因此 Makefile 中的delete_windows_files目标会删除所有oswindows的 cleaner XML、bleachbit/Winapp.py、bleachbit/Windows*.py及对应测试文件。这也是为什么仓库同时保留 Windows 与 Linux 代码而 DEB 包中只会出现 Linux 部分。安装到临时目录install目标执行$(MAKE) DESTDIR$(CURDIR)/debian/bleachbit prefix/usr install复用根目录 Makefile 的install目标把主程序bleachbit.py、桌面文件、AppStream 元数据、Python 源码、cleaners/*.xml、翻译po/下各语言.mo、图标与 PolicyKit 策略安装进包目录最后用desktop-file-install校验并注册管理员桌面文件。7.3 dsc、compat 与 changelog装配与版本信息bleachbit.dsc 声明Format: 1.0、Version: 6.0.5-0、Architecture: all并给出bleachbit_6.0.5.orig.tar.gz等上游源码包的校验和——OBS 在build bleachbit.dsc阶段正是依据它装配源码包。debian/compat 内容为9对应debian.rules中export DH_COMPAT9固定了 debhelper 的行为兼容级别debian/debian.changelog 则记录了6.0.5的升级历史供包版本信息与发布说明使用。八、仓库内可复用的替代构建路径除 OBS 外本仓库还提供了一套完全本地化的 Debian 包构建方案可视为 OBS 工作流的补充或离线备选Docker 容器构建docker/Dockerfile.debian 以debian:trixie为基础镜像预装debhelper、devscripts、fakeroot、lintian、python3-gi、gir1.2-gtk-3.0等全部构建依赖容器内打包脚本docker/inside_container.sh 的debian分支会把debian/debian.rules、debian/debian.control、debian/debian.changelog分别软链接为 debhelper 期望的rules、control、changelog随后执行dpkg-buildpackage -us -uc -b直接在本地产出.deb产物拷贝到/artifacts见 docker/inside_container.sh。这条路径与 OBS 使用同一套debian/元数据只是把构建环境从 OBS 服务器换成了本地容器。它在本地快速验证、无 OBS 账号或不想提交服务器时尤为实用。九、实践注意事项小结综合原文档与仓库源码使用 OBS 构建 BleachBit Debian 包时有以下几点值得留意osc账号登录是硬性前置客户端与 OBS 服务器交互必须登录未注册账号无法完成检出与提交仓库名是自定义标识osc build xUbuntu_20.10中的仓库名必须与所检出的 OBS 项目中已配置的仓库名一致不可凭空假设某个发行版名称一定存在先本地构建、再推送服务器在检出目录中先跑osc build验证可显著减少 OBS 服务器上的失败构建轮次测试性改动走分支用osc branch创建隔离分支如home:用户:branches:home:andrew_z/bleachbit避免影响正式包失败定位靠日志阶段osc results看哪个仓库/架构失败osc buildlog看哪个阶段、哪条命令失败例如日志末尾cloud132 failed build bleachbit.dsc即指 dsc 装配阶段失败Linux 包会自动剔除 Windows 内容make delete_windows_files会在构建期移除 Windows 专属 cleaner 与代码因此 DEB 包内不含 Windows 逻辑。这套检出 → 比对 → 本地构建 → 分支测试 → 提交 → 查状态 → 读日志的 osc 闭环是维护 BleachBit 发行版包的标准工作流而debian/目录下的元数据文件control、rules、dsc、compat则完整定义了 OBS 构建环境中的依赖与步骤理解它们即可从容地排查构建失败或自定义打包行为。赞分享桌面应用CLI【免费下载链接】bleachbitBleachBit system cleaner for Windows and Linux项目地址https://gitcode.com/gh_mirrors/bl/bleachbit点击查看免费下载相关推荐Kanidm Debian / Ubuntu 打包实战指南基于 kanidm_ppa_automation 构建与维护 .deb 软件包Kanidm Debian / Ubuntu 打包实战指南基于 kanidm_ppa_automation 构建与维护 .deb 软件包 本篇技术指南围绕 K后端认证鉴权安全QOwnNotes Debian 软件仓库基于 openSUSE Build Service 的 apt 源安装与使用指南QOwnNotes Debian 软件仓库基于 openSUSE Build Service 的 apt 源安装与使用指南 导读 QOwnNotes 在 A桌面应用QOwnNotes 在 Debian Linux 上的安装指南基于 OBS 仓库的 APT 配置全流程详解QOwnNotes 在 Debian Linux 上的安装指南基于 OBS 仓库的 APT 配置全流程详解 本文详细介绍如何在 Debian LinuxUn桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考