Skip to content

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模式(常用于门禁、全量源码构建等一次性场景)默认不开启增量编译,建议不更改默认的增量编译配置。