dlopen2

这是对原始库（现在不再维护）dlopen 的分支，更新了依赖项、修复了错误和一些新功能。

概述

这个库是我为了使Rust中的动态链接库使用变得简单而做的努力。之前存在的解决方案要么是不安全的，要么提供了巨大的开销，需要编写大量的代码才能完成简单的事情。我希望这个库能帮助你快速获得你需要的东西，避免错误。

快速示例

use dlopen2::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,
    // A function or field may not always exist in the library.
    example_c_fun_option: Option<unsafe extern "C" fn()>,
    example_reference_option:  Option<&'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;
    
    // Optional functions return Some(result) if the function is present or None if absent.
    unsafe{ cont.example_c_fun_option() };
    // Optional fields are Some(value) if present and None if absent.
    if let Some(example_reference) = &mut cont.example_reference_option {
        *example_reference = 5;
    }
}

功能

主要功能

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

与其他库的比较

安全

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

用法

Cargo.toml

[dependencies]
dlopen2 = "0.6"

文档

Cargo文档

许可证

本代码遵循MIT许可证。

变更日志

GitHub变更日志

致谢

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