Rust引用自定義c/c++庫

剛入坑Rust，由於公司項目需求，須要將libjpeg-turbo移植到Rust中，在使用NDK完成交叉編譯後，我對着幾個庫文件不知所措。國內Rust相關的文章太少，無奈只能到github和Stack Overflow上找答案。這篇文章的內容實際上是Rust FFI章節的相關知識，在這裏作一下總結。

FFI

ffi指的是 foreign function interface（我理解爲外部函數接口）
說白了就是rust調用c/c++和c/c++調用rust。無論是各種書籍和各種的教學文章裏都已經寫明瞭
他們改怎樣作，這裏咱們也就再也不囉嗦了。可是在編譯、構建方面，提到的內容比較少，大部分是
使用rustc命令作編譯連接(rustc -L /path/to/lib xxx.rs)。
涉及到cargo配置的不多不多。
複製代碼

相關連接: doc.rust-lang.org/cargo/refer…

在cargo book的Build Script裏的Outputs of the Build Script一節，教咱們如何配置build.rs來達到一些目的。在我最後作了一些嘗試後，找到了在cargo管理的項目中，如何配置連接咱們自定義的c/c++庫文件

實踐

首先準備好咱們須要連接的庫文件

$ touch test.c
複製代碼

內容以下

#include<stdio.h>
    void say_hello() 
    {
        printf("Hello Rust!\n");
    }
複製代碼

很是簡單的一個函數，接下來咱們把它編譯成.a的靜態庫

$ cc -c test.c -o test.o
    $ ar -r libtest.a test.o
複製代碼

接下來咱們使用cargo建立一個新的Rust工程

$ cargo new link_test --bin
複製代碼

這裏給你們安利一下IDE，我目前在使用AndroidStudio + Rust插件。InterliJ IDEA + Rust插件應該也不錯，沒試過。但AndroidStudio就是基於它開發的。

編輯Cargo.toml 內容以下

[package]
    name = "link_test"
    version = "0.1.0"
    authors = ["authors"]
    edition = "2018"
    
    build = "src/build.rs"
    
    [build-dependencies]
    dunce = "0.1.1"
複製代碼

在src目錄中建立build.rs(放在其餘目錄下也能夠須要在Cargo.toml中配置)

前方高能

build.rs內容以下:

extern crate dunce;
    use std::{env, path::PathBuf};
    
    fn main() {
        let library_name = "test";
        let root = PathBuf::from(env::var_os("CARGO_MANIFEST_DIR").unwrap());
        let library_dir = dunce::canonicalize(root.join("src")).unwrap();
        println!("cargo:rustc-link-lib=static={}", library_name);
        println!("cargo:rustc-link-search=native={}", env::join_paths(&[library_dir]).unwrap().to_str().unwrap());
    }
複製代碼

主要是這兩句:

println!("cargo:rustc-link-lib=static={}", library_name);
    println!("cargo:rustc-link-search=native={}",env::join_paths(&[library_dir]).unwrap().to_str().unwrap());
複製代碼

第一句是告訴cargo,配置rustc庫文件的類型和名稱,類型這裏咱們寫的是static由於用的是靜態庫還有dylib和framework能夠選,可是使用dylib鏈接動態庫我一直沒有成功,有搞過的大佬但願能夠指點一二(使用rustc --help命令能夠查看更多內容)。第二句是告訴cargo,配置rustc庫文件所在的目錄

接下來把咱們準備好的庫文件丟到src目錄下，來試試看咱們的配置有沒有效果，此時目錄結構以下:

|____Cargo.lock
    |____Cargo.toml
    |____src
    | |____build.rs
    | |____main.rs
    | |____libtest.a
複製代碼

打開咱們的main.rs添加一下代碼:

fn main() {
        unsafe { say_hello(); }
    }

    #[link(name = "test", kind = "static")]
    extern "C" {
        pub fn say_hello();
    }
複製代碼

最後

$ cargo run
    $ Hello Rust!
複製代碼

能夠看到，咱們c語言裏定義的函數已經被執行了！