【CXX】4.4 其他构建系统

你需要至少完成以下三件事：

1. 生成CXX生成的C++绑定代码。

2. 编译生成的C++代码。

3. 将生成的目标文件与你的其他C++和Rust目标文件链接在一起。

并非所有构建系统都是平等的。如果你希望使用90年代的构建系统，尤其是如果你希望覆盖2个或更多构建系统（如automake+cargo）的限制并期望同时解决它们，那么请注意你的期望值要相应调整。

生成代码

当#[cxx::bridge]过程宏展开时，CXX的Rust代码生成会在Rust编译过程中自动进行，因此不需要特殊的构建步骤。

但C++端的绑定代码需要生成。你的选择有：

1. 使用cxxbridge命令，这是一个独立的命令行工具，用于生成CXX的C++代码。配置你的构建系统来编译并调用这个工具。

$ 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++工具链链接器。相反，你需要选择以下选项之一：

1. 使用rustc作为最终链接器。 使用-L <目录>和-l<库>参数传递任何非Rust库，和/或在你的Rust代码中使用#[link]指令。如果需要链接C/C++的.o文件，可以使用-Clink-arg=file.o。

2. 使用你的C++链接器。 在这种情况下，你首先需要使用rustc和/或cargo生成一个Rust静态库目标（staticlib），并将其传递给你的外部链接器调用。

如果需要链接多个Rust子系统，你可能需要使用大量的extern crate语句来包含多个Rust rlib，生成一个单一的静态库。多个Rust静态库文件可能会冲突。

直接将Rust rlib传递给非Rust链接器是不支持的（但有时似乎有效）。