打赏

[易学易懂系列|rustlang语言|零基础|快速入门|(17)|装箱crates]

[易学易懂系列|rustlang语言|零基础|快速入门|(17)|装箱crates]

实用知识

装箱crates

我们今天来讲讲装箱技术crates。

什么是crates?

英语翻译是:

英 [kreɪt] 美 [kreɪt]

  • n. 板条箱;篓
  • vt. 将某物装入大木箱或板条箱中

[ 过去式 crated 过去分词 crated 现在分词 crating 复数 crates 第三人称单数 crates ]


其实,它也就是一种模块化封装技术。

我们还是来看看代码,我们先用命令:cargo new greetings 生成一个新的工程,工程目录如下 :

// # It generates,
greetings
 ├── Cargo.toml
 └── src
    └── main.rs

然后我们用vscode打开这个目录,在src目录下,新建一个lib.rs,并写入以下代码:

// 01. greetings/src/lib.rs
pub fn hello() {
    println!("Hello, world!");
}

在main.rs文件中写入以下代码:

// 02. greetings/src/main.rs
extern crate greetings;

fn main() {
    greetings::hello();
}

然后在当前工程目录下,powershell下运行以下命令:

cargo build

cargo run

打印结果为:Hello, world!

我来解释一下相关代码。

extern crate greetings;

这段代码什么意思呢?它代表链接到一个库:greetings

在Rust,

链接一个 crate 到这个新库,必须使用 extern crate 声明。这不仅会链接库,还会导入与库名相同的模块里面的所有项。适用于模块的可见性规则也适用于库。

这里我们要注意一点:

其中库的名字,不能像这样的加横杠线:“like-this”,而是用下划线:"like_this",如下:

extern crate like_this;

现在有另一种情景,当我们的库越来越大,怎么办?

我们可以把这些库统一放在一个crate中。

我们来看看例子。

先用命令创建相关目录:

// # Think we run,
cargo new phrases
cargo new phrases/greetings --lib

这两个命令将产生如下目录:

// # It generates,
phrases
 ├── Cargo.toml
 ├── greetings
 │  ├── Cargo.toml
 │  └── src
 │     └── lib.rs
 └── src
    └── main.rs

在目录phrases下的Cargo.toml文件最后一行,加入以下依赖信息:

greetings = { path = "greetings" }

在目录phrases/greetings/src/lib.rs文件中,更新为如下代码:

// 02. phrases/greetings/src/lib.rs
pub fn hello() {
    println!("Hello, world!");
}

在目录phrases/src/main.rs文件中,更新为如下代码:

// 03. phrases/src/main.rs
extern crate greetings;

fn main() {
    greetings::hello();
}

在工程目录phrases,运行:cargo run,应该会打印出一个正确结果:Hello, world!

我们看到,crate的依赖信息可以写到Cargo.toml文件中,非常方便。

当然,我们可以导入git中的代码库,如下:

/ -- Cargo.toml --
[dependencies]

// 01. Get the latest commit on the master branch
rocket = { git = "https://github.com/SergioBenitez/Rocket" }

// 02. Get the latest commit of a specific branch
rocket = { git = "https://github.com/SergioBenitez/Rocket", branch = "v0.3" }

// 03. Get a specific tag
rocket = { git = "https://github.com/SergioBenitez/Rocket", tag = "v0.3.2" }

// 04. Get a specific revision (on master or any branch, according to rev)
rocket = { git = "https://github.com/SergioBenitez/Rocket", rev = "8183f636305cef4adaa9525506c33cbea72d1745" }

当然我们可以从crate.io中导入依赖,比如我们从这个库:https://crates.io/crates/test_crate_hello_world

我们在依赖文件:目录phrases下的Cargo.toml,更新为如下信息:

[*dependencies*]

*#greetings = { path = "greetings" }*

test_crate_hello_world = "0.1.2"

在目录phrases/src/main.rs文件中,更新为如下代码:

extern crate test_crate_hello_world;
fn main() {
    println!("{}", test_crate_hello_world::hello());
}

在工程目录phrases,运行:cargo run,应该会打印出一个正确结果:Hello, world!

以上,希望对你有用。

如果遇到什么问题,欢迎加入:rust新手群,在这里我可以提供一些简单的帮助,加微信:360369487,注明:博客园+rust

参考文章:https://learning-rust.github.io/docs/d4.crates.html

posted @ 2019-12-08 11:37  gyc567  阅读(585)  评论(0编辑  收藏  举报