< 返回版块

Mike Tang 发表于 2020-09-10 20:33

Tags:rust,ffi

前面我们经历了《Rust FFI 编程 - 基础知识》、《Rust FFI 编程 - 手动绑定 C 库》和《Rust FFI 编程 - Rust 导出共享库》三个大的子系列,Rust FFI 编程的基础部分算靠以段落。可能仍然有未覆盖到的地方,可以在未来以补充文章的形式发布。

学以致用,现在我们开始进入新的阶段——应用。我们暂时规划了如下一些大的主题:

  • 自动化工具 bindgen 和 cbindgen 介绍;
  • Rust 交叉编译相关,Rust 在 Windows 平台的编译相关问题;
  • 某个 *-sys 库解析;
  • 使用 Rust 为其它动态语言写调用库:Python, Php, Nodejs, Ruby, Go, Java,Objective-C;、
  • 附录:Rust 二进制瘦身等;

另外,会单独开若干大的后续系列,不会放在本 FFI 系列中。

  • Rust 嵌入式开发系列
  • Rust 与 Wasm/WebAssembly 开发系列
  • Rust 高性能计算系列(待定)

bindgen 介绍

本篇,我们来介绍 rust-bindgen 这个项目。项目地址为:https://github.com/rust-lang/rust-bindgen。可以看到,这是一个 Rust 官方孵化的项目,目前已经比较成熟。

本篇只是一个总体的介绍,并不是对 bindgen 项目的完整讲解,也不是对 bindgen tutorial 的全面翻译。因此,真正动手操作的时候,需要仔细阅读 Tutorial 原文和查阅相关的 API

bindgen 是一个能自动为 C(或 C++)库生成 Rust 绑定的辅助库和命令行工具。C++ (目前)的支持并不完整。

也就是说,bindgen 可以作为一个 crate,与 Cargo 的 build.rs 机制配合,根据 C/C++ 的头文件(.h, .hpp),在构建阶段,编译主体 Rust 代码之前,自动生成 Rust 绑定文件。具体,可查看示例:https://rust-lang.github.io/rust-bindgen/tutorial-0.html

bindgen 还有另一种用法,它本身也提供一个命令行工具。执行:

cargo install bindgen

便可安装。 然后,在命令行下,使用

bindgen input.h -o bindings.rs

便可根据 C 头文件 input.h 动态生成 Rust 绑定文件 bindings.rs。非常简单。

但真实的场景远不如想象中这么纯洁。于是就有一堆可能的修补工作。bindgen 为我们提供了各种修补之法(这才是精华)。具体来说,有如下一些措施:

  • 白名单
  • 黑名单
  • Opaque 对象
  • 类型替换
  • 其它

这些措施有的可以用在库的模式下,命令行模式下,以及在源代码(C)的注释中添加标注的模式下。有的三种都能覆盖,有的只能覆盖其中一种或两种。具体可在 https://rust-lang.github.io/rust-bindgen/customizing-generated-bindings.html 页面找到详细解释。

同时,bindgen 对 C 的 Union 和 Bitfields 的特性,也有对应的处理策略。这些在实际封装的过程中,可能会经常碰到。

bindgen 本身知识点,并不多。重点在于实战,在实战中体会各种细节。后面我们也会拿一到两篇进行 bindgen 实战的讲解。

本篇内容就介绍到这里。

评论区

写评论
jellybobbin 2020-09-11 09:57

好啊!

1 共 1 条评论, 1 页