3 构建入口
3.1 宜将根目录的Cargo.toml作为构建入口以便调用cargo build完成命令构建;若通过构建脚本调用cargo build命令,则入口宜单一,入口统一命名为build.suffix
通过使用一致的构建入口点,构建过程可以变得更加高效和可自动执行。每个交付单元只有单一构建入口,便于一键式自动构建。suffix表示对应的构建脚本语言后缀,譬如.bat,.sh,.py等。对使用构建脚本调用cargo命令的场景,入口文件build.suffix的路径宜放在构建工程根目录下,或根目录的scripts等容易识别的目录中。对通过cmake/gradle等高等级框架调用Rust编译工具的场景,构建入口遵循高等级框架的。
3.2 支持重复编译
宜支持重复编译,以确保在编译成功后,在不对源代码做任何修改、不清理上次编译的中间件和发布件、不修改编译环境的条件下再次执行编译能重复编译成功
3.3 使用默认的增量编译配置
增量编译是指只编译修改的代码,而不是整个项目的方式,这种方法可以帮助减少编译时间,并提高编译效率。使用增量编译的方法是给rustc传递-C incremental=dir参数或者在Cargo.toml中做如下配置。
Rust
[build]
incremental = true # 是否开启增量编译
注1:Cargo在debug模式下(常用于开发本地编译等场景)默认开启增量编译,release模式(常用于门禁、全量源码构建等一次性场景)默认不开启增量编译,建议不更改默认的增量编译配置。