你需要至少完成以下三件事:
-
生成CXX生成的C++绑定代码。
-
编译生成的C++代码。
-
将生成的目标文件与你的其他C++和Rust目标文件链接在一起。
并非所有构建系统都是平等的。如果你希望使用90年代的构建系统,尤其是如果你希望覆盖2个或更多构建系统(如automake+cargo)的限制并期望同时解决它们,那么请注意你的期望值要相应调整。
生成代码
当#[cxx::bridge]过程宏展开时,CXX的Rust代码生成会在Rust编译过程中自动进行,因此不需要特殊的构建步骤。
但C++端的绑定代码需要生成。你的选择有:
- 使用cxxbridge命令,这是一个独立的命令行工具,用于生成CXX的C++代码。配置你的构建系统来编译并调用这个工具。
bash
$ cxxbridge src/bridge.rs --header > path/to/bridge.rs.h
$ cxxbridge src/bridge.rs > path/to/bridge.rs.cc
它被打包为cxxbridge-cmd crate发布在crates.io上,或者可以从CXX GitHub仓库的gen/cmd/目录中构建。
或者,基于cxx-gen crate构建你自己的代码生成器前端。目前这是非官方且不受支持的。
编译C++
随你喜欢。我们无法提供指导。
将C++和Rust链接在一起
当链接一个包含混合Rust和C++代码的二进制文件时,你需要选择使用Rust工具链(rustc)还是你已经深度调优的C++工具链。
生成的C++代码和由过程宏生成的Rust代码相互依赖。简单的示例可能只需要其中一种,但通常你的链接过程需要处理双向依赖。对于某些链接器(如llvm-ld),这根本不是问题。对于其他链接器(如GNU ld),--start-lib/--end-lib等标志可能会有所帮助。
Rust不会生成简单的独立.o文件,因此你不能直接将Rust生成的代码扔进现有的C++工具链链接器。相反,你需要选择以下选项之一:
-
使用rustc作为最终链接器。 使用-L <目录>和-l<库>参数传递任何非Rust库,和/或在你的Rust代码中使用#[link]指令。如果需要链接C/C++的.o文件,可以使用-Clink-arg=file.o。
-
使用你的C++链接器。 在这种情况下,你首先需要使用rustc和/或cargo生成一个Rust静态库目标(staticlib),并将其传递给你的外部链接器调用。
如果需要链接多个Rust子系统,你可能需要使用大量的extern crate语句来包含多个Rust rlib,生成一个单一的静态库。多个Rust静态库文件可能会冲突。
直接将Rust rlib传递给非Rust链接器是不支持的(但有时似乎有效)。