Cargo
Cargo 是 Rust 的构建系统和包管理工具,同时 Rustacean 们使用 Cargo 来管理它们的 Rust 项目。
Cargo 负责三个工作:构建你的代码,下载你代码依赖的库并编译这些库。我们把你代码需要的库叫做“依赖(dependencies)”因为你的代码依赖他们。
$ cargo --version
转换到 Cargo
- 创建源文件目录并移除旧的可执行文件
首先,回到你的终端,移动到你的hello_world目录,并输入如下命令:
$ mkdir src
$ mv main.rs src/main.rs # or 'move main.rs src/main.rs' on Windows
$ rm main # or 'del main.exe' on Windows
Cargo 期望源文件位于 src
目录,所以先做这个。
这样将项目顶级目录(在这里,是 hello_world)留给 README,license 信息和其他跟代码无关的文件。这样,Cargo 帮助你保持项目干净整洁。一切井井有条。
- 创建配置文件
下一步,在 hello_world 目录创建一个文件,叫做 Cargo.toml
。
这个文件使用 TOML(Tom’s Obvious, Minimal Language)格式。 TOML 类似于 INI,不过有一些额外的改进之处,并且被用作 Cargo 的配置文件。
输入如下内容
- Cargo.toml
[package]
name = "hello_world"
version = "0.0.1"
authors = [ "Your name <you@example.com>" ]
- 构建并运行 Cargo 项目
$ cargo build
Compiling hello_world v0.0.1 (file:///home/yourname/projects/hello_world)
$ ./target/debug/hello_world
Hello, world!
你刚刚用 cargo build
构建了一个程序,
并用 ./target/debug/hello_world
运行了它,
不过你也可以用如下的一步操作 cargo run
来完成这两步操作:
$ cargo run
Running `target/debug/hello_world`
Hello, world!
注意这个例子并没有重新构建项目。 Cargo 发现文件并没有被修改,所以它只是运行了二进制文件。如果你修改了源文件,Cargo 会在运行前重新构建项目,这样你将看到像这样的输出:
$ cargo run
Compiling hello_world v0.0.1 (file:///home/yourname/projects/hello_world)
Running `target/debug/hello_world`
Hello, world!
Cargo 检查任何项目文件是否被修改,并且只会在你上次构建后修改了他们才重新构建。 对于简单的项目,Cargo 并不比使用rustc要好多少,不过将来它会变得有用。 这在你开始使用 crate 时显得尤为正确;(crate)在其他语言中有“库(library)”或“包(package)”这样的同义词。对于包含多个 crate 的项目,让 Cargo 来协调构建将会轻松很多。 有了 Cargo,你可以运行cargo build,而一切将有条不紊的运行。
- 发布构建
当你的项目准备好发布了,可以使用 cargo build --release
来优化编译项目。
这些优化可以让 Rust 代码运行的更快,不过启用他们会让程序花更长的时间编译。
这也是为何这是两种不同的配置,一个为了开发,另一个构建提供给用户的最终程序。
那个 Cargo.lock
是什么?
运行这个命令同时也会让 Cargo 创建一个叫做 Cargo.lock 的文件,它看起来像这样:
[root]
name = "hello_world"
version = "0.0.1"
Cargo 用Cargo.lock文件跟踪你程序的依赖。这里是 Hello World 项目的Cargo.lock文件。 这个项目并没有依赖,所以内容有一点稀少。 事实上,你自己甚至都不需要碰这个文件;仅仅让 Cargo 处理它就行了。
就是这样!如果你一路跟过来了,你应该已经成功使用 Cargo 构建了hello_world。 虽然这个项目很简单,现在它使用了很多在你余下的 Rust 生涯中将会用到的实际的工具。 事实上,你可以期望使用如下命令的变体开始所有的 Rust 项目:
$ git clone someurl.com/foo
$ cd foo
$ cargo build
创建新 Cargo 项目的简单方法
你并不需要每次都过一遍上面的操作来开始一个新的项目!Cargo 可以快速创建一个骨架项目目录这样你就可以立即开始开发了。
用 Cargo 来开始一个新项目,在命令行输入 cargo new
:
$ cargo new hello_world --bin
这个命令传递了 --bin
参数因为我们的目标是直接创建一个可执行程序,而不是一个库。
可执行文件通常叫做二进制文件(因为它们位于 /usr/bin
,如果你使用 Unix 系统的话)。
Cargo 为我们创建了两个文件和一个目录:
一个 Cargo.toml
和一个包含了 main.rs
文件的 src 目录。
这应该看起来很眼熟,他们正好是我们在之前手动创建的那样。
这些输出是你开始所需要的一切。
首先,打开Cargo.toml。它应该看起来像这样:
[package]
name = "hello_world"
version = "0.1.0"
authors = ["Your Name <you@example.com>"]
[dependencies]
Cargo 已经根据你给出的参数和git全局配置给出了合理的默认配置。你可能会注意到 Cargo 也把hello_world目录初始化为了一个git仓库。
这是应该写入 src/main.rs
的代码:
fn main() {
println!("Hello, world!");
}
中文文档
参考资料
https://github.com/KaiserY/rust-book-chinese
更多学习
更多实时资讯,前沿技术,生活趣事。尽在【老马啸西风】
交流社群:[交流群信息](https://mp.weixin.qq.com/s/rkSvXxiiLGjl3S-ZOZCr0Q)