Rust 基础: 三方库依赖 & 自定义三方库

正文

今天来介绍一下如何在 rust 项目中依赖三方库，以及如何自定义一个三方库

1. 项目类型

在 Rust 中存在两种基础的项目类型

• 一种属于应用(
  
application

  )，主入口默认采用
  
src/main.rs

• 第二种为三方库(
  
library

  )，主入口为
  
src/lib.rs


了解两者的区别之后我们就可以来看看如何在项目中引入三方库

2. 引入官方三方库

• 
  rust 三方库 crates.io
  

我们知道 rust 项目主要使用 cargo 同时作为依赖管理和打包工具，因此我们只需要在

Cargo.toml

配置文件内标明依赖项目和版本号即可

• 
/app/Cargo.toml


[dependencies]
rand = "0.8.0"

接下来就可以在项目内来使用，使用

extern crate

关键字来引入三方库

• 
/app/src/main.rs


extern crate rand;

fn main() {
    println!("Hello, world!");
    let x: i32 = rand::random();
    println!("random x = {}", x);
}

• 输出

Hello, world!
random x = -700735415

3. 自定义三方库

而写一个自定义三方库也很简单，就是创建一个 library 项目就可以了！

3.1 创建库项目

$ cargo new lib --lib

3.2 加点内容

• 
/lib/src/lib.rs


注意三方库的主入口为

lib.rs


pub fn test_fn() {
    println!("invoke test_fn from lib");
}

pub fn add(x: i32, y: i32) -> i32 {
    x + y
}

3.3 引入自定义三方库

这时候我们就可以放着，回到 app 项目加入依赖

• 
/app/Cargo.toml


[dependencies]
lib = { path = "../lib" }

然后就可以在项目里面使用了

• 
/app/src/main.rs


extern crate lib;

fn main() {
    lib::test_fn();
    println!("1 + 2 = {}", lib::add(1, 2));
}

• 输出

invoke test_fn from lib
1 + 2 = 3

其他资源

参考连接

完整代码示例

https://github.com/superfreeeee/Blog-code/tree/main/back_end/rust/rust_dependency_library