Rust FFI 编程 - Bindgen 工具介绍

前面我们经历了《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 实战的讲解。

本篇内容就介绍到这里。