如何使用 C++/Qt/CMake 项目构建 Rust 代码？

Question

我有一个使用 CMake 构建的现有 C++/Qt项目。 我想开始添加可以从主 C++ 代码库中调用的 Rust 代码。

构建项目的正确方法是什么？

当前项目结构：

./CMakeLists.txt
./subproject-foo/CMakeLists.txt
./subproject-foo/src/...
./subproject-bar/CmakeLists.txt
./subproject-bar/src/...
./common/CMakeLists.txt
./common/src/...

我想添加一个结构相似的common-rust/...目录。

我怎样才能把它融入到项目中？

Answer 1

您可以使用ExternalProject模块 。 它旨在允许构建外部依赖项 - 甚至是那些不使用CMake的依赖项。 这是一篇关于使用它的有用文章 。

所以说你有“common-rust”子目录，它的Cargo.toml包含：

[package]
name = "rust_example"
version = "0.1.0"

[lib]
name = "rust_example"
crate-type = ["staticlib"]

它通过lib.rs公开一个函数add ：

#[no_mangle]
pub extern fn add(lhs: u32, rhs: u32) -> u32 {
    lhs + rhs
}

然后你的顶级CMakeLists.txt看起来像这样：

add_executable(Example cpp/main.cpp)

# Enable ExternalProject CMake module
include(ExternalProject)

# Set default ExternalProject root directory
set_directory_properties(PROPERTIES EP_PREFIX ${CMAKE_BINARY_DIR}/Rust)

# Add rust_example as a CMake target
ExternalProject_Add(
    rust_example
    DOWNLOAD_COMMAND ""
    CONFIGURE_COMMAND ""
    BUILD_COMMAND cargo build COMMAND cargo build --release
    BINARY_DIR "${CMAKE_SOURCE_DIR}/common-rust"
    INSTALL_COMMAND ""
    LOG_BUILD ON)

# Create dependency of Example on rust_example
add_dependencies(Example rust_example)

# Specify Example's link libraries
target_link_libraries(Example
    debug "${CMAKE_SOURCE_DIR}/common-rust/target/debug/librust_example.a"
    optimized "${CMAKE_SOURCE_DIR}/common-rust/target/release/librust_example.a"
    ws2_32 userenv advapi32)

set_target_properties(Example PROPERTIES CXX_STANDARD 11 CXX_STANDARD_REQUIRED ON)

当您将Rust目标构建为staticlib它会输出应链接的其他库。 我只在Windows上试过这个，因此ws2_32 ， userenv和advapi32是相互关联的。 这显然不是跨平台的，但您可以轻松地处理（例如，将变量设置为适合于if..else块内每个平台的依赖项列表，并将其附加到target_link_libraries调用中）。

另请注意，这取决于货物在路径中可用。

你现在应该好好去。 文件“cpp / main.cpp”可能包含以下内容：

#include <cstdint>
#include <iostream>

extern "C" {
  uint32_t add(uint32_t lhs, uint32_t rhs);
}

int main() {
  std::cout << "1300 + 14 == " << add(1300, 14) << '\n';
  return 0;
}

这是一个工作示例项目的链接。

Answer 2

现在有一个可以用来构建的项目：Corrosion https://github.com/corrosion-rs/corrosion

所以你的 CMakeLists.txt 会有这个：

# See the Corrosion README to find more ways to get Corrosion
find_package(Corrosion REQUIRED)

corrosion_import_crate(MANIFEST_PATH ${CMAKE_SOURCE_DIR}/common-rust)