Rust网络编程(4)-构建脚本

在实际的项目中，有些包需要编译第三方非Rust代码，例如 C库；有些包需要链接到 C库，当然这些库既可以位于系统上， 也可以从源代码构建。其它的需求则有可能是需要构建代码生成 。 在Cargo中，提供了构建脚本，来满足这些需求。

1. 概述

指定的build命令应执行的Rust文件，将在包编译其它内容之前，被编译和调用，从而具备Rust代码所依赖的构建或生成的组件。Build通常被用来：
构建一个捆绑的C库；
在主机系统上找到C库；
生成Rust模块；
为crate执行所需的某平台特定配置。

主要就是编译不同语言生成库，并调用

2. 基本使用

从这个案例可以看出，脚本build.rs可以在程序运行期间，动态变更脚本内容
在Cargo.toml中[package]，加入：build = "build.rs"，表示启动时会先编译执行该文件。
待编译脚本build.rs，从它生成文件hello.rs

use std::env;
use std::fs::File;
use std::io::Write;
use std::path::Path;

fn main() {
    let out_dir = env::var("OUT_DIR").unwrap();
    let dest_path = Path::new(&out_dir).join("hello.rs");
    let mut f = File::create(&dest_path).unwrap();

    f.write_all(b"
        fn say_hello() -> &'static str {
            \"hello\"
        }
    ").unwrap();
}

编译并调用脚本build.rs

include!(concat!(env!("OUT_DIR"), "/hello.rs"));

fn main() {
    println!("{}", say_hello());
}

3. 编译并调用C库

cargo.toml中加入依赖：

[package]
build = "build.rs"
[build-dependencies]
cc = "1.0"

src/hello.c

#include <stdio.h>

void hello() {
    printf("Hello, world! \n");
}

build.rs

extern crate cc;

fn main(){
    //将c文件编译为hello.o文件
    cc::Build::new().file("src/hello.c").compile("hello")
}

main.rs

extern { fn hello(); }

fn main() {
    //调用c语言需要加上unsafe
    unsafe {
        hello();
    }
}

总结

本文编辑完毕