Rust能力养成之（11）:用Cargo进行项目管理：详谈Cargo.toml

最新推荐文章于 2024-04-23 08:20:07 发布

海数据实验室

最新推荐文章于 2024-04-23 08:20:07 发布

阅读量3.2k

点赞数

本文链接：https://blog.csdn.net/qq_40433634/article/details/113437534

版权

前言

上一篇讲了

子命令定制与安装
用 Clippy来 Linting 代码

本篇会涉及

详谈Cargo.toml
用VSCode建立Rust开发环境

详谈Cargo.toml

应该说，Cargo严重依赖于相应的项目清单文件Cargo.toml来获取所有的项目信息。虽然之前对该文件介绍了一下,但还没有深入,这里我们仔细看一下这个文件以及其所包含的内容。

如之前已知，使用 crate new projectname 这个命令，可以得到一个默认的项目清单文件，内含一些能够使项目得以构建的必要信息。每个清单文件都可被划分为指定项目的不同属性的部分。以下我们看一个实例，来自一个较大型项目级别的清单文件。

如下所示：

# cargo_manifest_example/Cargo.toml# We can write comments with `#` within a manifest file
[package]name = "cargo-metadata-example"version = "1.2.3"description = "An example of Cargo metadata"documentation = "https://docs.rs/dummy_crate"license = "MIT"readme = "README.md"keywords = ["example", "cargo", "mastering"]authors = ["Jack Daniels <jack@danie.ls>", "Iddie Ezzard <iddie@ezzy>"]build = "build.rs"edition = "2018"
[package.metadata.settings]default-data-path = "/var/lib/example"
[features]default=["mysql"]
[build-dependencies]syntex = "^0.58"
[dependencies]serde = "1.0"serde_json = "1.0"time = { git = "https://github.com/rust-lang/time", branch = "master" }mysql = { version = "1.2", optional = true }sqlite = { version = "2.5", optional = true }

这里我们过一下这个清单文件，在[package]中

name：项目名称
version：项目版本
描述description：关于项目目的，方向等内容的基本描述
许可license:软件许可标识符，如http://spdx.org/licenses/所示者
readme:提供链接到项目存储库中的文件，这里就是一个项目介绍的入口
documentation文档:如果是一个库的crate，则包含到该crate文档的链接
keywords关键字:是若干单词的列表，用过通过搜索引擎或crate.io可以找到对应的项目
authors作者: 列出项目的主要作者
build构建:定义一段Rust代码(通常是build.rs)，以在程序的其余部分编译之前先编译并运行，通常用于生成代码或构建crate所依赖的本机库。
edition（Rust编译版本）:该条目指定编译项目时使用的版本。就现在而言，使用的是2018版，之前的还存在过一个2015版本，如果没有该条目，将被假定为默认版本。而使用2018版创建的项目是向后兼容的，这意味着也可以使用2015年的crate作为依赖项。