桌面应用音频处理【免费下载链接】picardPicard is a cross-platform music tagger powered by the MusicBrainz database项目地址https://gitcode.com/gh_mirrors/pi/picard点击查看免费下载本文是 MusicBrainz Picard跨平台音乐标签工具由 MusicBrainz 数据库驱动维护者的发布操作手册。它以仓库根目录下的 RELEASING.md 为核心骨架完整覆盖正式版本发布前的翻译同步、仓库清理、常量重生成、NEWS 撰写、版本号升级、签名标签、推送与回滚的全过程并结合 setup.py、picard/version.py 等源码说明每条命令背后的实现原理。读完本文你可以独立执行一次从 master 分支出发的稳定版本发布并在发布失败时安全回退。一、发布流程总览与前置约定Picard 的发布过程完全围绕 Git 仓库展开所有状态变更翻译 pot 文件、常量文件、NEWS.md、版本号都以 commit 形式落地最终以release-#.#.#格式的签名标签作为发布锚点。整体流程可划分为四个阶段发布准备期正式发布前数周/数天同步翻译模板、确认工作树干净。发布执行期重生成常量、撰写 NEWS、升级版本号、运行测试、创建签名标签。开发版本回切将版本号升为下一个 dev 版本并提交。推送与应急回滚推送 master 与标签必要时执行回滚命令恢复发布前状态。文档中的命令大量使用两个 shell 变量$PICARD_REMOTE远程仓库名如origin和$PICARD_VERSION/$PICARD_RELEASE_TAG。其中$PICARD_RELEASE_TAG即release-$PICARD_VERSION仓库中的 scripts/tools/tag-release.sh 正是这一约定的自动化实现它通过python -c import picard; print(picard.__version__)读取当前版本然后执行git tag --sign $TAG --messageRelease $PICARD_VERSION。二、发布准备期同步翻译模板与仓库清理2.1 同步 po/picard.pot 与源码Picard 的界面字符串使用 gettext 管理。主模板po/picard.pot需要从源码中重新提取以保证 Weblate 上翻译者看到的是最新字符串python setup.py regen_pot_file git diff --quiet || git commit -m Update pot file -- po/picard.pot这条命令的语义是先重新生成模板如果git diff检测到po/picard.pot发生变化git diff --quiet返回非零则提交该文件若没有变化则不做任何事。提取完成后推送到主远程仓库。关于翻译的完整说明见 po/README.md。从源码实现看regen_pot_file是 setup.py 中基于 Babelextract_messages自定义的命令类picard_regen_pot_file它固定输出到po/picard.pot输入目录为picard并刻意忽略const目录ignore_dirs (const,)。这是因为picard/const/下的常量字符串如标签名与描述属于独立翻译域需要单独提取python setup.py regen_constants_pot_file后者对应picard_regen_constants_pot_file命令输出po/constants/constants.pot。如果环境中没有安装 Babel这些命令会直接报错退出并提示Babel is required to use this command (see po/README.md)因此发布机必须预装 Babel。此外 AppStream 元数据与 XDG desktop 文件使用python setup.py regen_appdata_pot_file提取见 setup.py 的picard_regen_appdata_pot_file类内部调用xgettext --languageappdata与--languagedesktop再以msgmerge更新po/appstream/*.po。2.2 确保 Git 仓库工作树干净发布必须从一个干净、与远程完全一致的 master 分支出发避免带入未合入的本地改动。以下命令在本地仓库逐条执行# 1) 拉取远程并切到 master git fetch $PICARD_REMOTE git checkout master # 2) 硬重置到远程 master并清理未跟踪文件 git reset --hard $PICARD_REMOTE/master git clean -f -d # 3) 移除旧的编译模块防止过期 .pyc 干扰 find . -type f -name *.pyc -exec rm -f {} \; # 4) 打一个临时标签保存当前状态发布失败时可回退到这里 git tag before-release-$PICARD_VERSION --force # 5) 移除文件中可能残留的 BOM 字节正常情况下不应需要发布前检查更稳妥 git ls-tree --full-tree -r HEAD --name-only |while read f; do sed -i 1s/^\xEF\xBB\xBF// $f; done git diff --quiet || git commit -a -m Remove nasty BOM bytes第 5 条命令遍历版本库中所有被跟踪文件删除首行开头的 UTF-8 BOM\xEF\xBB\xBF若确有改动则统一提交为Remove nasty BOM bytes。这一步是防御性的BOM 字节可能导致 Python 源码解析或 gettext 提取出现问题发布前检查一次成本极低。三、同步生成的常量文件Picard 的两个常量模块picard/const/attributes.pyMB_ATTRIBUTES与picard/const/countries.pyRELEASE_COUNTRIES并非手写维护而是由翻译 pot 文件生成python setup.py update_constants git diff --quiet || git commit -a -m Update constants -- picard/const/*.py从 setup.py 的picard_update_constants命令类可以看到完整逻辑默认情况下它会先调用scripts/tools/pull-shared-translations.py从 Weblate 拉取最新的 attributes/countries 共享翻译该脚本面向https://translations.metabrainz.org/api/的musicbrainz项目仅拉取翻译完成度不低于 10% 的语言然后解析po/countries/countries.pot中带iso.code:注释的消息生成RELEASE_COUNTRIES字典解析po/attributes/attributes.pot中来自DB:cover_art_archive.art_type/name、DB:medium_format/name、DB:release_group_primary_type/name、DB:release_group_secondary_type/name、DB:release_status/name五类位置的字符串生成MB_ATTRIBUTES字典。最终通过 scripts/package/constants.py.in 模板写出两个.py文件文件头明确写着Automatically generated - dont edit。若发布机不便访问 Weblate可跳过拉取步骤、仅依据仓库内已有的 pot 文件重生成python setup.py update_constants --skip-pull四、更新 NEWS.md发布版本必须记录变更日志打开 NEWS.md在文件顶部为即将发布的版本新增一节。标题格式为## Version X.Y.Z - YYYY-MM-DD例如仓库当前顶部即为## Version 3.0.1 - 2026-10-08。变更按### Bugfixes、### New Features、### Improvements三类分列。每条变更应附带对应的 JIRA 工单链接格式如- [PICARD-123](https://tickets.metabrainz.org/browse/PICARD-123) - Description of the change。确保自上个版本以来的所有变更均已收录。NEWS.md 的格式不只是给人看的它同时是构建系统的数据源setup.py 中的picard_build_appdata命令会以正则^## Version (?Pversion\d(?:\.\d){1,2}) - (?Pdate\d{4}-\d{2}-\d{2})解析 NEWS.md为 AppStream 元数据生成release date... version.../列表。这意味着若标题格式写错生成的org.musicbrainz.Picard.appdata.xml发布列表就会为空——这也是 NEWS 中曾出现Generated Appstream appdata file has empty release list类缺陷的根源。发布期间可借助仓库工具快速核对变更内容python scripts/tools/changelog-for-version.py 3.0.1 # 从 NEWS.md 提取指定版本章节 python scripts/tools/authors-between-releases.py # 列出两个标签间的代码贡献者与翻译者五、升级 Picard 版本号并运行测试5.1 版本号的存放位置与结构版本号定义在 picard/init.py 顶部当前为PICARD_VERSION Version(3, 0, 1, final, 0)Version是 picard/version.py 中定义的 namedtuple五个字段为major, minor, patch, identifier, revision。其中identifier只能是dev、alpha、beta、rc、final之一a/b是alpha/beta的别名构造时会被归一化。short_str()输出 PEP 440 规范字符串final且 patch 为 0 时输出X.Y否则输出X.Y.Z预发布版本输出如3.0.0a4、3.0.0rc2、3.0.0.dev1等形式。版本比较通过sortkey属性完成其排序键为(major, minor, patch, 标识符权重, revision)权重顺序为dev(0) alpha(1) beta(2) rc(3) final(4)这保证3.0.0dev3.0.0rc3.0.0final的语义正确。相关行为均有 test/test_versions.py 覆盖例如test_version_conversion_short断言所有short_str()输出都符合 PEP 440 正则test_lt断言dev版本小于alpha版本。5.2 发布版与开发版的两次修改第一步设置为发布版本。编辑picard/__init__.py写入新的发布版本元组然后运行完整测试pytest测试通过后提交本次版本号变更。第二步发布标签创建之后切回开发版本。编辑picard/__init__.py将版本号升级为下一个开发版本例如发布3.0.1后设为3, 0, 2, dev, 0之类再次运行pytest提交变更。这样 master 分支始终指向下一个开发版本而发布版本只存在于标签上避免日常开发被固定为已发布版本号。提示每日构建场景下还可以使用python setup.py patch_version对应picard_patch_version命令它会用当前时间 UTC 戳改写picard/__init__.py中的PICARD_BUILD_VERSION_STR形如win32.20140415091256运行时__version__会自动追加build后缀而 scripts/tools/patch-version.sh 则是按最近发布标签以来的提交数-短哈希N-abc1234来打补丁版本供开发构建使用。六、创建签名发布标签git tag -s $PICARD_RELEASE_TAG -m Release $PICARD_VERSION稳定版标签命名规范release-#.#.#例如release-2.1.0、release-3.0.1。注意使用-s进行 GPG 签名保证标签可被验证、不可被篡改标签信息-m写明发布版本号这一步骤应在发布版本号提交之后、切换回 dev 版本之前执行因为标签要精确指向发布版本的提交。七、推送新提交与标签到远程git push $PICARD_REMOTE master:master git push $PICARD_REMOTE tag $PICARD_RELEASE_TAG第一条推送 master 分支包含 pot/常量/NEWS/版本号等全部发布提交第二条推送签名标签。推送完成后正式发布即告完成后续的安装包构建、签名与分发由 CI/打包脚本见 scripts/package 目录下的 Windows、macOS 打包脚本继续处理。7.1 发布后回滚push 之后如果推送后发现问题需要撤回RELEASING.md 提供了完整的回滚命令序列git tag -d release-$PICARD_VERSION # 删除本地发布标签 git reset --hard before-release-$PICARD_VERSION # 硬重置到发布前临时标签 git push $PICARD_REMOTE :$TAG # 删除远程标签 git push $PICARD_REMOTE before-release-$PICARD_VERSION:master --force # 强制将远程 master 推回发布前状态该流程依赖发布准备期创建的before-release-$PICARD_VERSION临时标签——这正是发布前先打状态保存标签这一步骤的意义所在。回滚属于强制推送操作应仅在确认需要放弃本次发布时使用并知会其他维护者。八、发布检查清单与关键文件速查将上述流程收敛为一张可逐项勾选的清单阶段操作验证方式准备期python setup.py regen_pot_file并提交po/picard.potgit diff --quiet确认无残留准备期fetch/reset/clean移除*.pyc处理 BOMgit status干净准备期git tag before-release-$PICARD_VERSION --forcegit tag -l可见临时标签常量python setup.py update_constants并提交picard/const/*.py检查picard/const/countries.py、attributes.py生成时间戳变更日志按## Version X.Y.Z - YYYY-MM-DD格式更新 NEWS.md用 scripts/tools/changelog-for-version.py 验证可提取版本号编辑 picard/init.py 为发布版本pytest全量通过标签git tag -s release-$PICARD_VERSIONgit tag -v验证签名回切版本号改为下一个 dev 版本pytest全量通过推送push master push tag远程git ls-remote确认回滚可选删除标签、reset 到 before-release 标签、强制推送远程恢复发布前状态涉及的核心文件与脚本发布流程文档RELEASING.md版本号定义picard/init.py、版本模型 picard/version.py发布相关自定义命令setup.pyregen_pot_file、regen_constants_pot_file、update_constants、patch_version、build_appdata等辅助脚本scripts/tools/README.md 下的 tag-release.sh、patch-version.sh、changelog-for-version.py、authors-between-releases.py翻译工作流po/README.md版本模型测试test/test_versions.py九、常见问题与注意事项Babel 缺失导致 regen 失败regen_pot_file依赖 Babel未安装时命令直接退出。发布前请按 po/README.md 的要求在发布环境安装 Babel 与 gettext 工具链。NEWS 标题格式不可随意改动picard_build_appdata依赖## Version X.Y.Z - YYYY-MM-DD精确格式生成 AppStream release 列表格式偏差会导致发布列表为空。update_constants需要 Weblate 访问权限不带参数时默认先拉取共享翻译需要 Weblate API key可在仓库根目录放置.weblate.ini或使用--weblate-key离线环境请使用--skip-pull。不要手工编辑生成文件picard/const/*.py与po/picard.pot都是生成物手工修改会在下次 re-gen 时被覆盖。发布版本必须是 finalpicard/version.py校验identifier合法性正式发布标签对应的版本应使用final标识预发布alpha/beta/rc流程相同但版本标识符不同标签命名建议沿用release-X.Y.Z前缀以便patch-version.sh等脚本用git describe --match release-*识别。以上流程即为 Picard 从代码就绪到版本发布上架的完整工程链路。维护者只需严格按照 RELEASING.md 的顺序执行即可保证每次发布的可复现性、可验证性与可回滚性。赞分享桌面应用音频处理【免费下载链接】picardPicard is a cross-platform music tagger powered by the MusicBrainz database项目地址https://gitcode.com/gh_mirrors/pi/picard点击查看免费下载相关推荐IPython 发布流程完全指南从发布说明、Git 标签到 PyPI 上传的 10 步操作手册IPython 发布流程完全指南从发布说明、Git 标签到 PyPI 上传的 10 步操作手册 本文以仓库内 docs/source/contributing开发工具KindEditor自定义工具栏配置打造符合业务需求的编辑界面KindEditor自定义工具栏配置打造符合业务需求的编辑界面 KindEditor是一款功能强大的富文本编辑器通过灵活的工具栏配置你可以轻松打造符合自身前端UI组件cryptography 项目发布流程实战指南从版本号提升、签名 Tag 到 PyPI 发布的完整操作手册cryptography 项目发布流程实战指南从版本号提升、签名 Tag 到 PyPI 发布的完整操作手册 导读 本文以 cryptography 项目官方发密码学上一篇react-admin 的 DateTimeInput 组件日期时间输入、格式转换与时区处理完整指南下一篇在 Ray Tune 中使用 Nevergrad无导数超参数优化的完整实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考