cargo release

功能

• 确保您处于良好的发布状态，包括
  • 正确的分支
  • 与远程同步
  • 干净的树状结构
• 支持使用 cargo 的原生标志的工作空间，如 --workspace、--exclude 和 --package
  • 更改版本时更新工作空间中依赖的 crates
  • 更改检测以帮助指导可能不需要发布的 crates
  • 可选地共享提交
• 处理 cargo publish、打标签和推送
• 预发布搜索和替换以更新自定义版本，包括
  • 更新更改日志
  • 更新 Dockerfile 中的标签
• 预发布钩子以进行额外自定义，包括
  • 生成 CHANGELOG

安装

当前发布版本：0.25.10

$ cargo install cargo-release

用法

$ cargo release [level]

• 有关 level、其他 CLI 参数和配置文件格式的更多信息，请参阅参考。
• 有关如何将 cargo-release 集成到您的工作流程中的帮助，请参阅常见问题解答。

先决条件

• 您的项目应由 git 管理。

dry run

默认情况下，cargo-release 以 dry-run 模式运行，这样您可以安全地运行它并验证它将执行的操作。

• 使用每个额外的 -v 增加日志级别以获取更多详细信息
• 通过跳过cargo-publish的验证步骤，使用--no-verify来加速dry-run。

准备好后，传递--execute标志。

相关工具

• release-pr 动作
• cargo-smart-release
• cargo-set-version
• cargo-unleash
• release-plz
• cargo-workspaces

Semver 兼容性

cargo-release的版本控制跟踪的是二进制文件的兼容性，而不是API。我们上传到crates.io以分发二进制文件。如果将其作为库使用，请确保使用=版本要求运算符来锁定版本。

许可证

根据您的选择，许可协议可以是以下之一

• Apache License 2.0 (LICENSE-APACHE或https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT或http://opensource.org/licenses/MIT)

。

贡献

除非您明确声明，否则根据Apache-2.0许可证定义的，您有意提交以包含在作品中的任何贡献，将根据上述方式双许可，没有额外的条款或条件。