rust-dlopen

概览

这个库是我努力让 Rust 中的动态链接库使用变得简单的成果。之前存在的解决方案要么不安全，要么需要编写大量代码才能完成简单的事情。我希望这个库能帮助您快速获得所需内容并避免错误。

快速示例

extern crate dlopen;
#[macro_use]
extern crate dlopen_derive;
use dlopen::wrapper::{Container, WrapperApi};

#[derive(WrapperApi)]
struct Api<'a> {
    example_rust_fun: fn(arg: i32) -> u32,
    example_c_fun: unsafe extern "C" fn(),
    example_reference: &'a mut i32,
}

fn main(){
    let mut cont: Container<Api> =
        unsafe { Container::load("libexample.so") }.expect("Could not open library or load symbols");
    cont.example_rust_fun(5);
    unsafe{cont.example_c_fun()};
    *cont.example_reference_mut() = 5;
}

特性

主要特性

• 支持大多数平台，且平台无关。
• 与 Rust 错误处理机制一致，使得出错变得更加困难。
• 非常轻量级。它主要使用零成本包装器在平台 API 上创建更安全的抽象。
• 线程安全。
• 面向对象编程友好。
• 提供低级 API，可提供使用库的完全灵活性。
• 提供两个高级 API，可防止悬垂符号 - 每个都有其独特的方式。
• 高级 API 支持将符号自动加载到结构中。您只需定义一个表示 API 的结构即可。其余的自动完成，只需编写少量代码。
• 自动加载符号有助于您遵循 DRY 原则。

与其他库比较

安全性

请注意，尽管Rust旨在成为100%安全的语言，但它尚未提供允许我创建100%安全库的机制，所以我只能接受99%。此外，动态链接库的本质需要将获取的指针转换为在应用程序端定义的类型。这无法保证安全。话虽如此，我仍然认为这个库提供了在Rust中可能的最佳方法和最大的安全性。

使用方法

Cargo.toml

[dependencies]
dlopen = "0.1"

文档

Cargo文档

许可协议

此代码遵照MIT许可协议。

变更日志

GitHub变更日志

致谢

特别感谢Simonas Kazlauskas，他的libloading成为了我的项目的代码基础。