目录 由 DocToc 生成

• Tpfs Logger Extensions
  • 不编译源代码即可快速检查
  • 运行构建和测试
  • 运行代码风格检查
  • 运行审计
  • 发布预发布Crates
  • 发布版本更改到Crates
  • 理解语义版本控制

Tpfs Logger Extensions

这为使用tpfs进行日志记录提供了扩展。

不编译源代码即可快速检查

cargo check

运行构建和测试

cargo make build
cargo make test

运行代码风格检查

cargo make lint

运行审计

cargo make audit

发布预发布Crates

请参阅版本指南以了解预发布版本： https://gitlab.com/TransparentIncDevelopment/docs/engineering-guide/blob/versioning-proposal/versioning.md

你应该使用预发布版本在一个不同的crates中测试一个概念。但这不是最终发布版本的目的。有关最终版本发布，请参阅发布crates更改。

你可以通过在gitlab中找到相应的管道并点击旁边 manual-publish-prerelease-crate 作业旁边的播放按钮来手动推送分支的预发布版本。当发生合并到master时，预发布crates也将自动发布。

发布版本更改到Crates

应该通过 语义版本控制 维护crates的版本，并有一些辅助脚本可以帮助更新Cargo.toml和Cargo.lock文件中的版本。这个版本更改可以在你的分支上发生，希望在MR被批准合并之前。

使用以下之一

• cargomake publish-patch
• cargomake publish-minor
• cargomake publish-major

为了实际发布更改，这应该在MR合并到master之后完成。一旦合并，从master拉取并重新基础，然后使用脚本助手标记发布。

它看起来像这样

git checkout master
git pull
cargo make tag-release
git push --tags

理解语义版本控制

我们在我们的工程指南中写了一些东西： https://gitlab.com/TransparentIncDevelopment/docs/engineering-guide/blob/versioning-proposal/versioning.md

语义化版本控制（semver）的基本原则是，如果只有修复和调整，那么它只是一个补丁版本号的增加。如果有功能上的新增，则是小版本号的增加，如果是破坏性更改，则是大版本号的增加。优先级是，如果因为破坏性更改而进行大版本号增加，它将包括所有新增功能，而无需增加小版本号。同样，小版本号的增加也有优先级，高于补丁版本号的增加。

例如，如果版本号是 1.0.0，并且有新增功能和一些修复，则版本更新为 1.1.0。