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支持自动将符号加载到结构体中。您只需要定义一个表示API的结构体。其余的操作会自动进行，并且只需编写少量代码。
• 自动加载符号有助于您遵循DRY（不要重复自己）原则。

与其他库比较

安全性

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

使用

Cargo.toml

[dependencies]
dlopen = "0.1"

文档

Cargo文档

许可证

此代码基于MIT许可证。

变更日志

GitHub变更日志

致谢

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