ReVanced Patches Template 版本管理指南：语义化版本与自动化发布

ReVanced Patches Template 是一个专业的 Android 应用修改框架模板，采用先进的语义化版本控制和自动化发布流程来确保项目的稳定性和可维护性。本指南将详细介绍如何利用这个模板实现高效的版本管理。

什么是语义化版本控制？

语义化版本控制（SemVer）是一种标准的版本号格式规范，格式为 MAJOR.MINOR.PATCH：

• 主版本号（MAJOR）：不兼容的 API 修改
• 次版本号（MINOR）：向下兼容的功能性新增
• 修订号（PATCH）：向下兼容的问题修正

在 ReVanced Patches Template 中，当前版本 1.0.1 就遵循了这一规范，可以通过 gradle.properties 文件进行配置。

自动化发布流程详解

ReVanced Patches Template 集成了完整的自动化发布工具链：

核心发布工具

• semantic-release：自动化版本管理和发布
• @semantic-release/changelog：自动生成更新日志
• @semantic-release/git：提交版本变更到 Git 仓库
• gradle-semantic-release-plugin：Gradle 项目集成支持

发布配置说明

项目的发布配置在 build.gradle.kts 文件中定义，包括：

• Maven 发布到 GitHub Packages
• 自动签名验证
• DEX 文件构建和打包

版本管理最佳实践

提交消息规范

遵循约定式提交（Conventional Commits）规范，让工具能够自动分析提交类型并确定版本号变更：

feat: 添加新功能 → 次版本号增加
fix: 修复问题 → 修订号增加
BREAKING CHANGE: 重大变更 → 主版本号增加

开发分支策略

项目支持开发版本管理，如 1.0.1-dev.1 这样的开发版本号，便于在正式发布前进行测试。

更新日志自动生成

ReVanced Patches Template 的 CHANGELOG.md 文件完全由工具自动生成：

• 按版本号分组显示变更
• 清晰的功能、修复分类
• 包含开发版本记录

快速开始指南

环境准备

确保系统已安装：

• Java 11+
• Android SDK
• Node.js（用于语义化发布工具）

版本发布流程

1. 开发功能：按照提交规范进行代码提交
2. 触发发布：推送到主分支或创建发布标签
3. 自动执行：
   • 分析提交消息
   • 确定新版本号
   • 更新 gradle.properties 中的版本
   • 生成更新日志
   • 发布到 Maven 仓库

常见问题解答

如何手动发布版本？

虽然推荐使用自动化流程，但也可以通过修改 gradle.properties 文件中的 version 属性来手动设置版本号。

如何处理重大变更？

当需要进行不兼容的 API 修改时，确保提交消息包含 BREAKING CHANGE 描述，工具会自动提升主版本号。

通过采用 ReVanced Patches Template 的版本管理方案，开发者可以专注于功能开发，而版本控制和发布工作将完全自动化，大大提升开发效率和项目质量。🚀