第一次使用 sbt-release 发布项目从 SNAPSHOT 到正式版本的完整实战【免费下载链接】sbt-releaseA release plugin for sbt项目地址: https://gitcode.com/gh_mirrors/sb/sbt-release对于使用 Scala 和 sbt 的开发者来说sbt-release是解决发布难题的一把利器。作为一款专为 sbt 设计的 release 插件它把检查代码 → 跑测试 → 改版本号 → 打标签 → 发布构件 → 提交推送这一整套烦琐流程自动化让你只需敲下一个release命令就能轻松完成从 SNAPSHOT 快照版本到正式版本的发布。本篇文章将带你从零开始用最简单的步骤跑通第一次发布。什么是 sbt-release一个命令搞定整个发布流程sbt-release 是一款开源的 sbt 发布插件灵感来源于 Maven 的 maven-release-plugin但去掉了那些令人头疼的复杂配置。它最大的特点是发布流程完全可定制你可以像搭积木一样自由增删发布步骤。它的核心设计理念有两个不碰构建文件版本号写入独立的version.sbt文件而不是修改build.sbt避免破坏构建定义步骤化发布每个发布动作都是一个ReleaseStep按顺序执行任何一步失败都会中止整个发布保证发布过程的安全性。相关源码可参考ReleasePlugin.scala、Version.scala。安装 sbt-release 插件的两个步骤第一步在 plugins.sbt 中添加插件依赖在你的项目根目录下编辑project/plugins.sbt文件加入以下一行addSbtPlugin(com.github.sbt % sbt-release % 1.4.0)如果还没有这个文件直接新建即可。插件要求 sbt 1.x 及以上版本。第二步让版本遵循语义化规范sbt-release 要求你的项目版本遵循语义化版本SemVer规范例如1.2.3、1.2.3-SNAPSHOT、1.2-beta.1都是合法的。常规做法是日常开发使用1.0.0-SNAPSHOT发布时由插件自动帮你去掉-SNAPSHOT变成正式版本。一键发布sbt-release 默认发布流程详解安装完成后在 sbt 控制台输入release回车插件会依次执行以下 11 个步骤检查当前目录是否为 Git 仓库且没有未提交的变更检查是否存在 SNAPSHOT 快照依赖如有会询问你是否继续询问发布版本号和下一个开发版本号提供合理的默认值执行clean清理执行test:test运行测试任何测试失败都会中止发布将发布版本号写入version.sbt并应用到当前构建提交version.sbt的变更为上一个提交打上v版本号标签如v1.2.3执行publish发布构件到仓库将下一个开发版本号如1.0.1-SNAPSHOT写入version.sbt提交变更并推送到远程仓库。整个默认流程定义在releaseProcess设置中见 ReleasePlugin.scala。非交互式发布四个常用参数让你省心省力如果不想在终端里一个个回答提问sbt-release 提供了丰富的命令行参数with-defaults使用默认值直接发布无需交互是 CI/CD 场景的首选skip-tests跳过测试适合凌晨两点的紧急修复发布cross开启跨 Scala 版本构建发布release-version/next-version直接指定发布版本号和下一个开发版本号。示例命令release with-defaults release release-version 1.0.99 next-version 1.2.0-SNAPSHOT release cross with-defaults自定义版本号递增策略Major、Minor 还是 Next每个团队的版本管理习惯不同sbt-release 通过releaseVersionBump设置提供了 6 种版本递增策略策略说明示例Major递增主版本号1.0.0 → 2.0.0Minor递增次版本号1.0.0 → 1.1.0Bugfix递增修订号1.0.0 → 1.0.1Nano递增微型版本号1.0.0.0 → 1.0.0.1Next默认递增最后一个版本段1.0.0-RC1 → 1.0.0-RC2NextStable跳过预发布限定符1.0.0-RC1 → 1.0.0在build.sbt中配置即可releaseVersionBump : sbtrelease.Version.Bump.Minor相关实现可参考 Version.scala。定制专属发布流程删掉不需要的步骤默认流程并不一定适合所有项目比如不用 Git 的项目就可以去掉提交和推送步骤。sbt-release 把每个步骤都定义成ReleaseStep你可以自由重组import ReleaseTransformations._ releaseProcess : SeqReleaseStep上面的配置就移除了一切 Git 相关步骤只保留检查快照 → 测试 → 设置版本 → 发布 → 设置下个版本。如果你还需要执行自定义任务插件还提供了releaseStepTask、releaseStepCommand等辅助函数可以把任意 sbt 任务或命令包装成发布步骤。常见问题与避坑指南Q发布时提示working directory has untracked filesA默认情况下commitReleaseVersion步骤会检查未跟踪文件并中止发布。如果确认没问题可设置releaseIgnoreUntrackedFiles : true跳过检查。Q发布时提示 SNAPSHOT 依赖如何自动确认A使用release with-defaults参数插件会自动选择默认值不继续避免交互卡住。Q打标签的默认命名是什么A默认标签名为v版本号如v1.2.3可通过releaseTagName和releaseTagComment自定义。Q如何配置发布到 Maven 中央仓库A配合 sbt-pgp 插件设置releasePublishArtifactsAction : PgpKeys.publishSigned.value即可发布签名构件。结语现在就去体验第一次发布吧sbt-release 把发布这件高频但高风险的事情变得简单可靠。无论是个人开源项目还是团队协作只需几分钟配置就能拥有标准化、可重复、可审计的发布流程。建议你从release with-defaults开始体验再逐步探索自定义发布步骤和跨版本构建让发布从此成为一件轻松的事。想深入了解可以继续阅读项目源码目录src/main/scala/ 下的实现以及 src/sbt-test/ 中的各类测试场景动手跑一遍比看十遍文档更有收获。【免费下载链接】sbt-releaseA release plugin for sbt项目地址: https://gitcode.com/gh_mirrors/sb/sbt-release创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考